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 ein Objekt 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, bestimmte Eigenschaften eines Objekts über die Sicht "Eigenschaften" und andere Werte auf den 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
   >

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

Im Folgenden ist ein Beispiel für die Definition einer Eigenschaftenseite dargestellt:

   <extension point="org.eclipse.ui.propertyPages">
      <page
         id="com.xyz.projectPage"
         name="XYZ Java Properties"
         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 implementiert.

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 Corp. 2000, 2001. Alle Rechte vorbehalten.