Eigenschaftenseiten

Kennung: org.eclipse.ui.propertyPages

Beschreibung: An diesem Erweiterungspunkt können zusätzliche Eigenschaftenseiten für Objekte eines bestimmten Typs hinzugefügt werden. Sobald diese Eigenschaftenseiten definiert sind, werden Sie im Dialog "Eigenschaften" für Objekte des entsprechenden Typs angezeigt.

Eine Eigenschaftenseite ist eine benutzerfreundliche Möglichkeit für die Interaktion mit den Eigenschaften eines Objekts. Anders als die Sicht "Eigenschaften", die den verfügbaren Platz für die Bearbeitung einer Objekteigenschaft einschränkt, bietet eine Eigenschaftenseite den Vorteil, dass umfangreichere und komplexere Steuerelemente mit Bezeichnungen, Symbolen usw. definiert werden können. Eigenschaften, die logisch zusammengehören, können ebenfalls auf einer Seite zusammengefasst werden, statt in der Sicht "Eigenschaften" verstreut zu sein. In den meisten Anwendungen ist es jedoch sinnvoll, manche Eigenschaften eines Objekts über die Sicht "Eigenschaften" und andere über die Eigenschaftenseiten anzugeben.

Eigenschaftenseiten werden in einem Dialogfenster angezeigt, das normalerweise aufgerufen wird, wenn im Kontextmenü eines Objekts die Option "Eigenschaften" ausgewählt wird. Neben der Objektklasse kann optional der Namensfilter angegeben werden, damit Eigenschaftenseiten nur für spezifische Objekttypen registriert werden.

Wenn diese Filtermechanismen ungeeignet sind, kann eine Eigenschaftenseite den Mechanismus filter verwenden.  In diesem Fall werden die Attribute des Zielobjekts in einer Reihe von Schlüssel-/Wertpaaren beschrieben. Die auf die Auswahl angewendeten Attribute sind typspezifisch und gelten über die Domäne der Workbench selbst hinaus. Die Workbench delegiert die Filterung auf dieser Stufe daher an die tatsächliche Auswahl.

Konfigurationsbefehle:

   <!ELEMENT page (filter)*>
   <!ATTLIST page
      id           CDATA         #REQUIRED
      name         CDATA         #REQUIRED
      icon         CDATA         #IMPLIED
      objectClass  CDATA         #REQUIRED
      class        CDATA         #REQUIRED
      nameFilter   CDATA         #IMPLIED
      adaptable    (true|false)  #IMPLIED
   >

   <!ELEMENT filter EMPTY>
   <!ATTLIST filter
      name       CDATA #REQUIRED
      value      CDATA #REQUIRED
   > Beispiele:

Das folgende Beispiel ist die Erweiterung einer Eigenschaftenseite:

   <extension point="org.eclipse.ui.propertyPages">
      <page
         id="com.xyz.projectPage"
         name="XYZ-Java-Eigenschaften"
         objectClass="org.eclipse.core.resources.IFile"
         class="com.xyz.ppages.JavaPropertyPage"
         nameFilter="*.java">
         <filter name="readOnly" value="true"/>
      </page>
    </extension>

API-Informationen: Das Attribut class muss den vollständig qualifizierten Namen einer Klasse angeben, die org.eclipse.ui.IWorkbenchPropertyPage implement.

Bereitgestellte Implementierung: Für einige durch die Workbench bereitgestellte Objekte können Eigenschaftenseiten registriert sein. Plug-ins können weitere Eigenschaftenseiten für diese Objekte hinzufügen. Die Verwendung von Eigenschaftenseiten ist nicht auf Workbench-Ressourcen beschränkt: Alle in der Workbench angezeigten Objekte (sogar domänenspezifische Objekte, die durch die Plug-ins erstellt werden) können Eigenschaftenseiten verwenden, und andere Plug-ins können Eigenschaftenseiten für diese Objekte registrieren.

Copyright IBM Corporation und Andere 2000, 2002. Alle Rechte vorbehalten.