O ponto de extensão
org.eclipse.ui.preferencePages permite-lhe contribuir com páginas para
a caixa de diálogo
(
Janela > Preferências) das preferências gerais. A caixa de
diálogo preferências apresenta uma lista hierárquica das entradas de
preferências de utilizador. Cada entrada apresenta uma página de preferências correspondente quando seleccionada.
A ferramenta readme utiliza este ponto de extensão para adicionar a página de preferências Exemplo Readme.
<extension point = "org.eclipse.ui.preferencePages"> <page id="org.eclipse.ui.examples.readmetool.Page1" class="org.eclipse.ui.examples.readmetool.ReadmePreferencePage" name="%PreferencePage.name"> </page> </extension>
Esta marcação define uma página de preferências chamada "Exemplo Readme" que é implementada pela classe ReadmePreferencePage. A classe deve implementar a interface IWorkbenchPreferencePage.
A área de trabalho utiliza os mecanismos de preferências de tempo de execução centrais para aceder a todos os nós na árvore de preferências e páginas correspondentes. Esta lista pode ser inicializada a partir de informações no serviço de preferências sem executar código de plug-in algum.
A preferência "Exemplo Readme" é adicionada ao nível superior da árvore de preferências à esquerda. E isto porquê? Porque será adicionado um contributo de página de preferências enquanto raiz da árvore, a menos que seja especificado um atributo categoria. (O termo categoria é algo que pode induzir em erro. Talvez caminho seja um termo mais apropriado.) O atributo categoria especifica o ID (ou uma sequência de IDs a partir da raiz) da página ascendente. Por exemplo, a seguinte marcação criaria uma segunda página de preferências de ferramenta readme, "Página Descendente Exemplo Readme", como descendente da página original.
<extension point = "org.eclipse.ui.preferencePages"> <page id="org.eclipse.ui.examples.readmetool.Page1" class="org.eclipse.ui.examples.readmetool.ReadmePreferencePage" name="%PreferencePage.name"> </page> <page id="org.eclipse.ui.examples.readmetool.Page2" class="org.eclipse.ui.examples.readmetool.ReadmePreferencePage2" name="Página Descendente Exemplo Readme" category="org.eclipse.ui.examples.readmetool.Page1> </page> </extension>
Uma vez que o utilizador seleccionar a entrada para uma página de preferências na árvore à esquerda, a área de trabalho irá criar e apresentar uma página de preferências com a classe especificada na definição da extensão. Esta acção é o que activa o plug-in (se não estiver já activado devido a outra operação por parte do utilizador).