Sichten

org.eclipse.ui.views

An diesem Erweiterungspunkt können zusätzliche Sichten für die Workbench definiert werden. Eine Sicht ist eine optische Komponente in einer Workbenchseite. Sie wird normalerweise zur Navigation in einer Hierarchie von Informationen (z. B. dem Arbeitsbereich), zum Öffnen eines Editors oder zum Anzeigen der Eigenschaften für den aktiven Editor verwendet. Der Benutzer kann eine Sicht über das Menü 'Fenster' > 'Sicht anzeigen' anzeigen lassen oder über die lokale Titelleiste der Sicht schließen.

Um den Dialog "Sicht anzeigen" nicht optisch zu überfrachten, sollten Sichten in Kategorien gruppiert werden.

<!ELEMENT extension (category | view | stickyView)*>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT category EMPTY>

<!ATTLIST category

id             CDATA #REQUIRED

name           CDATA #REQUIRED

parentCategory CDATA #IMPLIED>


<!ELEMENT view (description?)>

<!ATTLIST view

id                 CDATA #REQUIRED

name               CDATA #REQUIRED

category           CDATA #IMPLIED

class              CDATA #REQUIRED

icon               CDATA #IMPLIED

fastViewWidthRatio CDATA #IMPLIED

allowMultiple      (true | false) >


<!ELEMENT description (#PCDATA)>

Ein optionales Unterelement, dessen Hauptteil einen Text als Kurzbeschreibung der Sicht enthalten sollte.



<!ELEMENT stickyView EMPTY>

<!ATTLIST stickyView

id        CDATA #REQUIRED

location  (RIGHT|LEFT|TOP|BOTTOM)

closeable (true | false)

moveable  (true | false) >

Bei einer permanenten Sicht handelt es sich um eine Sicht, die standardmäßig in allen Perspektiven eines Fensters erscheint, sobald es geöffnet wird. Ihre anfängliche Position ist durch das Positionsattribut festgelegt, sie kann von dem Benutzer jedoch versetzt oder geschlossen werden. Die Verwendung dieses Elements führt nur zum Erstellen eines Platzhalters für diese Sicht, es wird nicht die Sicht angezeigt. Bitte beachten Sie, dass bei der Verwendung dieses Elements sehr vorsichtig vorgegangen werden muss und es nur auf Sichten angewandt werden sollte, die wirklich unmittelbar über Perspektiven benötigt werden. Seit 3.0



Die folgenden Angaben sind ein Beispiel für den Erweiterungspunkt:

   

<extension point=

"org.eclipse.ui.views"

>

<category id=

"com.xyz.views.XYZviews"

name=

"XYZ"

/>

<view id=

"com.xyz.views.XYZView"

name=

"XYZ View"

category=

"com.xyz.views.XYZviews"

class=

"com.xyz.views.XYZView"

icon=

"icons/XYZ.gif"

/>

</extension>

Im Folgenden wird ein Beispiel für die Deklaration einer permanenten Sicht dargestellt:

   

<extension point=

"org.eclipse.ui.views"

>

<stickyView id=

"com.xyz.views.XYZView"

/>

</extension>

Der Wert des Attributs class muss der vollständig qualifizierter Name der Klasse sein, die org.eclipse.ui.IViewPart implementiert. Es ist gängige Praxis, org.eclipse.ui.part.ViewPart bei der Entwicklung einer neuen Sicht als Unterklasse zu definieren.

Die Eclipse-Plattform stellt eine Reihe von Standardsichten zur Verfügung, unter ihnen die Sichten "Navigator", "Eigenschaften", "Gliederung" und "Tasks". Aus Sicht des Benutzers unterscheiden sich diese Sichten nicht von anderen Sichten, die durch Plug-ins bereitgestellt werden. Alle diese Sichten können über das Untermenü "Sicht anzeigen" im Menü "Fenster" angezeigt werden. Die Position einer Sicht bleibt permanent erhalten. Sie wird gespeichert, wenn die Sicht geschlossen wird, und beim erneuten Öffnen der Sicht in derselben Sitzung wiederhergestellt. Die Position bleibt auch zwischen Workbenchsitzungen erhalten.