Benutzervorgabenseiten

Kennung: org.eclipse.ui.preferencePages

Beschreibung: Die Workbench stellt eine gemeinsames Dialogfenster für Benutzervorgaben zur Verfügung. 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 eines 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
   >

   <!ELEMENT page EMPTY>

   <!ATTLIST page
      id       CDATA #REQUIRED
     name     CDATA #REQUIRED
     class    CDATA #REQUIRED
     category CDATA #IMPLIED
   >

Beispiele: Das folgende Beispiel zeigt den Erweiterungspunkt für 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 IBM Corporation und Andere. Alle Rechte vorbehalten. Dieses Programm und sein Begleitmaterial werden gemäß den Bedingungen in 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.