Eigenschaftenseiten

org.eclipse.ui.propertyPages

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

<!ELEMENT extension (page*)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT page (filter* , keywordReference*)>

<!ATTLIST page

id          CDATA #REQUIRED

name        CDATA #REQUIRED

icon        CDATA #IMPLIED

objectClass CDATA #REQUIRED

class       CDATA #REQUIRED

nameFilter  CDATA #IMPLIED

adaptable   (true | false)

category    CDATA #IMPLIED>


<!ELEMENT filter EMPTY>

<!ATTLIST filter

name  CDATA #REQUIRED

value CDATA #REQUIRED>

Mit diesem Element wird der Attributstatus jedes Objektes 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üssen org.eclipse.ui.IActionFilter implementieren oder zugeordnet sein.



<!ELEMENT keywordReference EMPTY>

<!ATTLIST keywordReference

id CDATA #IMPLIED>

Ein Verweis einer Eigenschaftenseite auf ein Schlüsselwort. Weitere Informationen finden Sie unter Erweiterungspunkt des Schlüsselworts.



Das folgende Beispiel ist eine Definition einer Eigenschaftenseite:

   

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

Das Attribut class muss den vollständig qualifizierten Namen einer Klasse angeben, die org.eclipse.ui.IWorkbenchPropertyPage implementiert.

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.