Widoki

org.eclipse.ui.views

Ten punkt rozszerzenia umożliwia definiowanie dodatkowych widoków dla środowiska roboczego. Widok jest wizualnym komponentem strony środowiska roboczego. Zwykle służy do poruszania się w ramach hierarchii informacji (takiej jak obszar roboczy), otwierania edytorów oraz wyświetlania właściwości aktywnego edytora. Użytkownik może wyświetlić widok za pomocą menu Okna > Widok lub zamknąć go przy użyciu lokalnego paska tytułu widoku.

Aby zmniejszyć szum informacyjny w oknie dialogowym Pokaż widok, należy grupować widoki przy użyciu kategorii.

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

Opcjonalny podelement, którego treść powinien stanowić krótki opis widoku.



<!ELEMENT stickyView EMPTY>

<!ATTLIST stickyView

id        CDATA #REQUIRED

location  (RIGHT|LEFT|TOP|BOTTOM)

closeable (true | false)

moveable  (true | false) >

Widok o ustalonym położeniu to taki widok, który po otwarciu okna jest domyślnie wyświetlany we wszystkich jego perspektywach. Jego początkowe położenie zależy od atrybutu location, ale użytkownik może go dowolnie przenosić i zamykać. Użycie tego elementu spowoduje tylko utworzenie obiektu zastępczego widoku, a nie wyświetlenie samego widoku. Należy pamiętać, aby ostrożnie używać tego elementu i stosować go tylko w widokach, które muszą być wyświetlane we wszystkich perspektywach. Dostępne od wersji 3.0.



Poniżej przedstawiono przykład punktu rozszerzenia:

   

<extension point=

"org.eclipse.ui.views"

>

<category id=

"com.xyz.views.XYZviews"

name=

"XYZ"

/>

<view id=

"com.xyz.views.XYZView"

name=

"Widok XYZ"

category=

"com.xyz.views.XYZviews"

class=

"com.xyz.views.XYZView"

icon=

"icons/XYZ.gif"

/>

</extension>

Poniżej przedstawiono przykład deklaracji widoku o ustalonym położeniu:

   

<extension point=

"org.eclipse.ui.views"

>

<stickyView id=

"com.xyz.views.XYZView"

/>

</extension>

Wartość atrybutu class musi być pełną nazwą klasy implementującej interfejs org.eclipse.ui.IViewPart. Częstą praktyką przy opracowywaniu nowego widoku jest tworzenie podklasy klasy org.eclipse.ui.part.ViewPart.

Na platformie Eclipse dostępnych jest wiele widoków standardowych, takich jak Nawigator, Właściwości, Schemat i Czynności. Z punktu widzenia użytkownika widoki te niczym się nie różnią od każdego innego widoku udostępnianego przez moduły dodatkowe. Wszystkie widoki można wyświetlić przy użyciu podmenu Pokaż widok dostępnego w menu Okna. Pozycja widoku jest ustalona, ponieważ zostaje ona zapisana w momencie zamknięcia widoku i zostaje odtworzona po jego ponownym otwarciu w ramach tej samej sesji. Jego pozycja nie zmienia się także między sesjami środowiska roboczego.