Voorkeurenpagina's

org.eclipse.ui.preferencePages

De workbench biedt ondersteuning voor een gebruikelijk dialoogvenster voor voorkeuren. Het doel van dit extensiepunt is om plugins pagina's toe te laten voegen aan het voorkeurenvenster. Als het voorkeurenvenster is geopend (geïnitialiseerd vanuit de menubalk), worden op deze manier aangeleverde pagina's aan het dialoogvenster toegevoegd.

In het voorkeurenvenster worden de pagina's hiërarchische gegroepeerd. Daarom kan voor een pagina optioneel het kenmerk category worden opgegeven. Dit kenmerk bevat een pad dat bestaat uit bovenliggende pagina-ID's die zijn gescheiden door een schuine streep ('/'). Als dit kenmerk ontbreekt of als een van de bovenliggende knooppunten in het pad niet kan worden gevonden, wordt de pagina op het hoogste niveau toegevoegd.

<!ELEMENT extension (page*)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT page (keywordReference*)>

<!ATTLIST page

id       CDATA #REQUIRED

name     CDATA #REQUIRED

class    CDATA #REQUIRED

category CDATA #IMPLIED>


<!ELEMENT keywordReference EMPTY>

<!ATTLIST keywordReference

id CDATA #REQUIRED>

Een verwijzing naar een sleutelwoord vanuit een voorkeurenpagina. Zie het extensiepunt voor sleutelwoorden.



Dit is een voorbeeld van de extensie preferencePages:

   

<extension point=

"org.eclipse.ui.preferencePages"

>

<page id=

"com.xyz.prefpage1"

name=

"XYZ"

class=

"com.xyz.prefpages.PrefPage1"

>

<keywordReference id=

"xyz.Keyword"

/>

</page>

<page id=

"com.xyz.prefpage2"

name=

"Toetsenbordinstellingen"

class=

"com.xyz.prefpages.PrefPage2"

category=

"com.xyz.prefpage1"

>

</page>

</extension>

De waarde van het kenmerk class moet de volledig gekwalificeerde naam zijn van de klasse die org.eclipse.ui.IWorkbenchPreferencePage implementeert.

De workbench voegt verschillende pagina's toe voor het instellen van de platformvoorkeuren. Pagina's die met deze extensie zijn geregistreerd, worden hierna toegevoegd op basis van de categorie-informatie.