Benutzervorgabenseiten

org.eclipse.ui.preferencePages

Die Workbench enthält ein allgemeines Dialogfenster für Benutzervorgaben. Zweck dieses Erweiterungspunkts ist es, Plug-ins das Hinzufügen von Seiten zum Dialogfenster "Benutzervorgaben" zu ermöglichen. Beim Öffnen des Dialogfensters "Benutzervorgaben" (über die Menüleiste) werden auf diese Weise ergänzte Seiten zum Dialogfenster hinzugefügt.

Im Dialogfenster "Benutzervorgaben" können die Seiten hierarchisch gruppiert werden. Aus diesem Grund kann eine Seite optional ein Attribut category angeben. Dieses Attribut stellt einen Pfad dar, der sich aus den IDs von übergeordneten Seiten zusammensetzt, die durch das Zeichen / voneinander getrennt werden. Wenn dieses Attribut übergangen oder einer der Elternknoten im Pfad nicht gefunden wird, wird die Seite zur Ausgangsebene hinzugefügt.

<!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>

Ein Verweis einer Benutzervorgabenseite auf ein Schlüsselwort. Weitere Informationen finden Sie unter Erweiterungspunkt des Schlüsselworts.



Das folgende Beispiel ist ein Erweiterungspunkt für die Benutzervorgaben:

   

<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=

"Keyboard Settings"

class=

"com.xyz.prefpages.PrefPage2"

category=

"com.xyz.prefpage1"

>

</page>

</extension>

Der Wert des Attributs "class" muss den vollständig qualifizierten Namen einer Klasse darstellen, die org.eclipse.ui.IWorkbenchPreferencePage implementiert.

Die Workbench fügt mehrere Seiten hinzu, auf denen die Benutzervorgaben für die Plattform definiert werden können. Seiten, die über diese Erweiterung definiert werden, werden anhand ihrer Kategorieangaben nach diesen Seiten hinzugefügt.