Bod rozšíření org.eclipse.ui.preferencePages umožňuje přispívat stránkami do obecných předvoleb dialogového okna (Okno->Předvolby). Dialogové okno předvoleb předkládá hierarchický seznam položek uživatelských předvoleb. Každá položka při svém vybrání zobrazuje odpovídající stránku předvoleb.
Nástroj README používá tento bod rozšíření k přidání stránky předvoleb Příklad 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>
Tato značka definuje stránku předvoleb s názvem "Příklad souboru README", která je implementována prostřednictvím třídy ReadmePreferencePage. Tato třída musí implementovat rozhraní IWorkbenchPreferencePage.
Pracovní plocha používá mechanizmus předvoleb jádra běhové komponenty k přístupu ke všem uzlům ve stromě předvoleb a k jejich odpovídajícím stránkám. Tento seznam může být inicializován z informace ve službě předvoleb bez spouštění jakéhokoliv kódu modulu plug-in.
Předvolba "Příklad README" je přidána do nejvyšší úrovně stromu předvoleb na levou stranu. Proč? Protože příspěvek stránky předvoleb bude přidán jako kořen stromu, pokud nebude specifikován atribut kategorie. (Slovo kategorie je poněkud zavádějící. Možná lepší pojmenování by bylo cesta.) Atribut kategorie specifikuje identifikátor (nebo sekvence identifikátorů z kořene) nadřazené stránky. Například následující značka by měla vytvořit druhou stránku předvoleb nástroje README, "Podřízená stránka příkladu README," jako podřízený prvek původní stránky.
<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="Readme Example Child Page" category="org.eclipse.ui.examples.readmetool.Page1> </page> </extension>
Jakmile uživatel vybere položku pro stránku předvoleb ve stromě na levé straně, modul workbench vytvoří a zobrazí stránku předvoleb prostřednictvím třídy specifikované v definici rozšíření. Tato akce je tím, co aktivuje modul plug-in (pokud již nebyl aktivován kvůli jiné operaci uživatele).