Páginas de Preferências
Identificador:
org.eclipse.ui.preferencePages
Descrição:
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.
Marcação da Configuração:
<!ELEMENT extension (page*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - um identificador totalmente qualificado 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 - um nome exclusivo que será utilizado para identificar esta página.
- name - um nome traduzível que será utilizado na UI para esta página.
- class - um nome da classe totalmente qualificada que implementa org.eclipse.ui.IWorkbenchPreferencePage.
- category - um caminho que indica a localização da página na árvore de preferências. O caminho pode ser um ID de nó ascendente ou uma sequência de IDs separados pelo carácter '/', representando o caminho completo do nó raiz.
<!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.
- id - o id da palavra-chave referenciada.
Exemplos:
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>
Informações de API:
O valor do atributo class deve representar um nome totalmente qualificado da classe que implementa org.eclipse.ui.IWorkbenchPreferencePage.
Implementação Fornecida:
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.
Copyright (c) 2002, 2005 IBM Corporation e outros.
Todos os direitos reservados. Este programa e os materiais que o acompanham estão disponíveis
sob os termos da Eclipse Public License v1.0 que acompanha
esta distribuição e está disponível em http://www.eclipse.org/legal/epl-v10.html