Páginas de Preferências

org.eclipse.ui.preferencePages

A área de trabalho fornece uma caixa de diálogo comum para as preferências. O objectivo deste ponto de extensão é permitir aos conectores adicionar páginas à caixa de diálogo de preferências. Quando a caixa de diálogo de preferências é aberta (iniciada na barra do menu), as páginas que são uma contribuição deste modo serão adicionadas à caixa de diálogo.

A caixa de diálogo de preferências disponibiliza agrupamento hierárquico de páginas. Por esta razão, uma página pode especificar opcionalmente um atributo category. Este atributo representa um caminho composto por IDs de páginas ascendentes separados pelo carácter '/'. Se este atributo for omitido ou se algum dos nós ascendentes no caminho não for encontrado, a página será adicionada ao nível 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ências a uma palavra-chave. Consulte o ponto de extensão de palavras-chave.



A seguir encontra-se um exemplo para o ponto de extensão das 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 do atributo class deve representar um nome totalmente qualificado da classe que implementa org.eclipse.ui.IWorkbenchPreferencePage.

A área de trabalho adiciona várias páginas para definir as preferências da plataforma. As páginas registadas através desta extensão serão adicionadas posteriormente, de acordo com a informação de categoria.