Páginas de Preferência
Identificador:
org.eclipse.ui.preferencePages
Descrição:
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.
Marcação de Configuração:
<!ELEMENT extension (page*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - um identificador completo do ponto de extensão de destino
- id - um identificador opcional da instância de extensão
- name - um nome opcional da instância de extensão
<!ELEMENT page (keywordReference*)>
<!ATTLIST page
id CDATA #REQUIRED
name CDATA #REQUIRED
class CDATA #REQUIRED
category CDATA #IMPLIED>
- id - nome único que será utilizado para identificar essa página.
- name - nome traduzível que será utilizado na UI para essa página.
- class - nome de classe completo que implementa org.eclipse.ui.IWorkbenchPreferencePage.
- category - um caminho indicando a localização da página na árvore das preferências. O caminho pode ser um ID de nó pai ou uma seqüência de IDs separados por '/', representando um caminho completo a partir do nó raiz.
<!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.
- id - O ID da palavra-chave o qual está sendo referido.
Exemplos:
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>
Informações sobre API:
O valor da classe de atributo deve representar um nome completo da classe que implementa org.eclipse.ui.IWorkbenchPreferencePage.
Implementação Fornecida:
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.
Direitos Autorais (c) 2002, 2005 IBM Corporation e outros.
Todos os direitos reservados. Este programa e os materiais que o acompanham são disponibilizados
sob os termos da Eclipse Public License v1.0 que acompanha esta
distribuição e estão disponíveis no endereço http://www.eclipse.org/legal/epl-v10.html