Voorkeurenpagina's
ID:
org.eclipse.ui.preferencePages
Beschrijving:
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.
Configuratiemarkup:
<!ELEMENT extension (page*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - een volledig gekwalificeerd ID van het doelextensiepunt.
- id - een optioneel ID van de extensie-instance.
- name - een optionele naam van de extensie-instance.
<!ELEMENT page (keywordReference*)>
<!ATTLIST page
id CDATA #REQUIRED
name CDATA #REQUIRED
class CDATA #REQUIRED
category CDATA #IMPLIED>
- id - een unieke naam die wordt gebruikt voor het identificeren van deze pagina.
- name - een vertaalbare naam die voor deze pagina wordt gebruikt in de gebruikersinterface.
- class - de volledig gekwalificeerde naam van een klasse die org.eclipse.ui.IWorkbenchPreferencePage implementeert.
- category - een pad dat de locatie van de pagina in de voorkeurenstructuur aangeeft. Het pad kan het ID van een bovenliggend knooppunt zijn of een reeks ID's die zijn gescheiden door en schuine streep ('/'), waarmee het volledige pad vanuit het hoofdknooppunt wordt aangegeven.
<!ELEMENT keywordReference EMPTY>
<!ATTLIST keywordReference
id CDATA #REQUIRED>
Een verwijzing naar een sleutelwoord vanuit een voorkeurenpagina. Zie het extensiepunt voor sleutelwoorden.
- id - het ID van het sleutelwoord waarnaar wordt verwezen.
Voorbeelden:
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>
API-informatie:
De waarde van het kenmerk class moet de volledig gekwalificeerde naam zijn van de klasse die org.eclipse.ui.IWorkbenchPreferencePage implementeert.
Verstrekte implementatie:
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.
Copyright (c) 2002, 2005 IBM Corporation en anderen.
Alle rechten voorbehouden. Dit programma en het begeleidende materiaal zijn beschikbaar gesteld onder de voorwaarden van de Eclipse Public License v1.0 die bij deze distributie is geleverd en beschikbaar is op http://www.eclipse.org/legal/epl-v10.html.