Přispívání do stránky předvoleb

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.

Stránka předvoleb pracovní plochy

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).