org.eclipse.ui.preferencePages-laajennuspisteen avulla voit lisätä sivuja
yleisten oletusasetusten (
Ikkuna > Oletusasetukset) valintaikkunaan. Oletusasetusten valintaikkuna
esittää hierarkkisen luettelon käyttäjän oletusasetusmerkinnöistä.
Kukin merkintä tuo näkyviin vastaavan oletusasetussivun, kun merkintä valitaan.
Tämän laajennuspisteen avulla readme-työkalu lisää Readme-esimerkki-oletusasetussivun.
<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>
Tämä merkintä määrittää oletusasetussivun nimeltä "Readme-esimerkki", jonka toteuttaa luokka ReadmePreferencePage. Luokan on toteutettava IWorkbenchPreferencePage-rajapinta.
Työympäristö käyttää oletusasetusrakenteen kaikkia solmuja ja niitä vastaavia sivuja ajonaikaisen ympäristön ytimen oletusasetusmekanismien avulla. Tämän luettelon voi alustaa oletusasetuspalvelun tiedoista ajamatta mitään lisäosakoodia.
"Readme-esimerkki"-oletusasetus on lisätään vasemmalla olevan oletusasetusrakenteen ylätasolle. Miksi?Koska oletusasetussivun lisäys lisätään rakenteen pääobjektina,jos category-määritettä ei ole määritetty.(Nimi category on hieman harhaanjohtava. Parempi nimi voisi olla path.)Category-määrite määrittää pääsivun tunnuksen (tai sarjan tunnuksia päätasolta).Esimerkiksi seuraava merkintä loisi toisen readme-työkalun oletusasetussivun ("Readme-esimerkin alisivu") alkuperäisen sivun alisivuksi.
<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>
Kun käyttäjä valitsee oletusasetussivun merkinnän vasemmalla olevasta rakenteesta, työympäristö luo ja tuo näkyviin oletusasetussivun sen luokan avulla, joka on määritetty laajennuksen määrityksessä. Tämä toiminto aktivoi lisäosan, jos sitä ei vielä ollut aktivoitu.