Páginas de Preferência

org.eclipse.ui.preferencePages

O workbench fornece uma caixa de diálogo comum para preferências. O propósito desse ponto de extensão é permitir ao plug-ins incluir páginas à caixa de diálogo de preferência. Quando a caixa de diálogo de preferências for aberta (inicializada a partir da barra de menus), as páginas que contribuem com esse modo serão incluídas na caixa de diálogo.

A caixa de diálogo de preferências serve para o agrupamento hierárquico das páginas. Por essa razão, uma página pode opcionalmente especificar um atributo de category. Esse atributo representa um caminho composto de IDs de páginas pais separados por '/'. Se esse atributo estiver omitido ou se quaisquer dos nós pais no caminho não puder ser encontrado, ele será incluído no nível da raiz.

<!ELEMENT extension (page*)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT page (keywordReference*)>

<!ATTLIST page

id       CDATA #REQUIRED

name     CDATA #REQUIRED

class    CDATA #REQUIRED

category CDATA #IMPLIED>


<!ELEMENT keywordReference EMPTY>

<!ATTLIST keywordReference

id CDATA #REQUIRED>

Uma referência por uma página de preferência para uma palavra-chave. Consulte o ponto de extensão de palavras-chave.



A seguir está um exemplo para o ponto de extensão de preferências:

   

<extension point=

"org.eclipse.ui.preferencePages"

>

<page id=

"com.xyz.prefpage1"

name=

"XYZ"

class=

"com.xyz.prefpages.PrefPage1"

>

<keywordReference id=

"xyz.Keyword"

/>

</page>

<page id=

"com.xyz.prefpage2"

name=

"Keyboard Settings"

class=

"com.xyz.prefpages.PrefPage2"

category=

"com.xyz.prefpage1"

>

</page>

</extension>

O valor da classe de atributo deve representar um nome completo da classe que implementa org.eclipse.ui.IWorkbenchPreferencePage.

O workbench inclui várias páginas para definir as preferências da plataforma. As páginas registradas através dessa extensão serão incluídas após as mesmas, de acordo com as informações de suas categorias.