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
>
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.