Az org.eclipse.ui.preferencePages kiterjesztési pont segítségével oldalakat adhat hozzá az általános beállítások (Ablak->Beállítások) párbeszédablakhoz. A beállítások párbeszédablak megjeleníti a felhasználói beállításbejegyzések listáját. Minden bejegyzés kiválasztáskor megjelenít egy megfelelő minden beállításoldalt.
A readme eszköz ezt a kiterjesztési pontot használja a Readme példa beállításokoldal hozzáadásához.
<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>
Ez a leírónyelv megad egy "Readme Example" nevű beállításoldalt, amelyet a ReadmePreferencePage osztály valósít meg. Az osztálynak meg kell valósítani az IWorkbenchPreferencePage felületet.
A munkaterület a központi futási környezet beállításmechanizmusait használja az összes csomópont eléréséhez a beállításfában és a megfelelő oldalakon. Ez a lista inicializálható a beállítások szolgáltatás információiból a bedolgozókód futtatása nélkül.
A "Readme példa" beállítás hozzáadásra kerül a baloldalon lévő beállításfa felső szintjéhez. Miért?Mivel a beállításoldal a fa gyökereként kerül hozzáadásra, hacsak nincs category attribútum megadva. (A category név félrevezető lehet. A path talán jobb név.) A category attribútum megadja a szülőoldal azonosítóját (vagy azonosítók sorozatát a gyökérből).Az alapértelmezett leírónyelv például létrehozna egy második readme eszköz beállításoldalt - a "Readme példa leszármazott oldalt " - az eredeti oldal leszármazottjaként.
<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>
Ha a felhasználó kiválasztja a baloldalon lévő fa beállításoldalához tartozó bejegyzést, akkor a munkaterület létrehoz és megjelenít egy beállításoldalt a kiterjesztés definícióban megadott osztály segítségével. Ez a tevékenység aktiválja a bedolgozót (ha még nem került aktiválásra másik felhasználói tevékenység által).