Beschreibung: An diesem Erweiterungspunkt können zusätzliche Eigenschaftenseiten für Objekte eines bestimmten Typs hinzugefügt werden. Sobald die Seiten definiert wurden, werden sie im Dialog "Eigenschaften" für Objekte dieses 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 Bereich für die Bearbeitung einer Objekteigenschaft einschränkt, kann eine Eigenschaftenseite von der Möglichkeit profitieren, größere und komplexere Steuerelemente mit Bezeichnungen, Symbolen usw. zu definieren. Logisch zusammengehörende Eigenschaften können außerdem auf einer Seite zusammengefasst werden, statt über die gesamte Eigenschaftenseite verteilt 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.
Falls diese Filtermechanismen ungeeignet sind, kann eine Eigenschaftenseite einen eigenen Filtermechanismus verwenden. In diesem Fall werden die Attribute des Zielobjekts in einer Reihe von Schlüssel/Wert-Paaren beschrieben. Die für die Auswahl geltenden Attribute sind typspezifisch und gehen über die Domäne der eigentlichen Workbench hinaus. Daher delegiert die Workbench die Filterung auf dieser Ebene an die aktuelle Auswahl.
Konfigurationsbefehle:
<!ELEMENT extension (page*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA
#IMPLIED
name CDATA
#IMPLIED
>
<!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)
>
<!ELEMENT filter EMPTY>
Mit diesem Element wird der Attributstatus aller Objekte in der aktuellen Auswahl ausgewertet. Eine Übereinstimmung liegt nur dann vor, wenn alle Objekte in der Auswahl den angegebenen Attributstatus aufweisen. Alle Objekte in der Auswahl müssenorg.eclipse.ui.IActionFilter implementieren oder zugeordnet sein.
<!ATTLIST filter
<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 definiert 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 (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.