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 EMPTY>
<!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.
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"
>
</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, 2004 IBM Corporation und Andere.
Alle Rechte vorbehalten. Dieses Programm und sein Begleitmaterial werden gemäß
den Bedingungen der 'Common Public License v1.0' zur Verfügung gestellt, die diese Verteilung begleitet und
unter http://www.eclipse.org/legal/cpl-v10.html abgerufen
werden kann.