Benutzervorgabenseiten
Kennung:
org.eclipse.ui.preferencePages
Beschreibung:
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.
Konfigurationsbefehle:
<!ELEMENT extension (page*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - Vollständig qualifizierte Kennung des Zielerweiterungspunktes
- id - Optionale ID des Erweiterungsexemplars
- name - Optionaler Name des Erweiterungsexemplars
<!ELEMENT page (keywordReference*)>
<!ATTLIST page
id CDATA #REQUIRED
name CDATA #REQUIRED
class CDATA #REQUIRED
category CDATA #IMPLIED>
- id - Ein eindeutiger Name, der diese Seite kennzeichnet.
- name - Ein übersetzbarer Name, der in der
Benutzerschnittstelle
für diese Seite verwendet wird.
- class - Der Name einer vollständig qualifizierten Klasse,
die
org.eclipse.ui.IWorkbenchPreferencePage implementiert.
- category - Ein Pfad, der die Position der Seite in der
Baumstruktur der Benutzervorgaben angibt. Der Pfad kann entweder die ID eines übergeordneten Knotens sein oder eine
Folge von IDs, die durch das Zeichen / voneinander getrennt sind und
den vollständigen Pfad vom Anfangsknoten aus angeben.
<!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.
- id - Die ID des Schlüsselworts, auf das verwiesen wird.
Beispiele:
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>
API-Informationen:
Der Wert des Attributs "class" muss
den vollständig qualifizierten Namen einer Klasse darstellen, die
org.eclipse.ui.IWorkbenchPreferencePage implementiert.
Bereitgestellte Implementierung:
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.
Copyright (c) 2002, 2005 IBM Corporation und Andere.
Alle Rechte vorbehalten. Dieses Programm und sein Begleitmaterial werden gemäß den Bedingungen der "Eclipse Public License v1.0" zur Verfügung gestellt, die dieser Lieferung beiliegt und unter
http://www.eclipse.org/legal/epl-v10.html abgerufen werden kann.