Widoki
Identyfikator:
org.eclipse.ui.views
Opis:
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.
Znaczniki konfiguracji:
<!ELEMENT extension (category | view | stickyView)*>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - pełny identyfikator docelowego punktu rozszerzenia.
- id - opcjonalny identyfikator instancji rozszerzenia.
- name - opcjonalna nazwa instancji rozszerzenia.
<!ELEMENT category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory CDATA #IMPLIED>
- id - unikalna nazwa, która będzie używana do identyfikowania tej kategorii.
- name - możliwa do przetłumaczenia nazwa, która będzie oznaczać tę
kategorię w interfejsie użytkownika.
- parentCategory - opcjonalna ścieżka złożona z identyfikatorów
kategorii rozdzielonych znakami ukośnika (/). Umożliwia to utworzenie
hierarchii kategorii.
<!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) >
- id - unikalna nazwa, która będzie używana do identyfikowania tego
widoku.
- name - możliwa do przetłumaczenia nazwa, która będzie oznaczać ten
widok w interfejsie użytkownika.
- category - opcjonalny atrybut złożony z identyfikatorów kategorii rozdzielonych znakami ukośnika (/). Każda przywoływana kategoria musi być zadeklarowana w odpowiednim elemencie kategorii.
- class - pełna nazwa klasy implementującej interfejs
org.eclipse.ui.IViewPart. Częstą praktyką jest tworzenie podklasy
klasy org.eclipse.ui.part.ViewPart w celu dziedziczenia jej
domyślnych funkcji.
- icon - względna nazwa ikony, która będzie powiązana z tym widokiem.
- fastViewWidthRatio - procent szerokości środowiska roboczego, którą
zajmie ten widok jako aktywny widok szybki. Argument ten należy zdefiniować
jako wartość zmiennopozycyjną z przedziału od 0,05 do 0,95. W przypadku braku tej wartości zostanie użyty współczynnik domyślny.
- allowMultiple - opcja wskazująca, czy widok zezwala na tworzenie
wielu instancji za pomocą metody IWorkbenchPage.showView(String id,
String secondaryId). Wartość domyślna to 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.
- id - identyfikator widoku, który ma mieć ustalone położenie.
- location - opcjonalny atrybut określający położenie widoku o ustalonym położeniu względem obszaru edytora. Jeśli brak tego atrybutu, widok będzie dokowany
z prawej strony obszaru edytora.
- closeable - opcjonalny atrybut określający, czy powinna istnieć
możliwość zamykania widoku. Jeśli brak braku tego atrybutu, widok będzie można
zamykać.
- moveable - opcjonalny atrybut określający, czy powinna istnieć
możliwość przenoszenia widoku. Jeśli brak tego atrybutu, widok będzie można
przenosić.
Przykłady:
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>
Informacje o interfejsie API:
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.
Dostarczana implementacja:
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.
Copyright (c) 2002, 2005 IBM Corporation i inne podmioty.
Wszelkie prawa zastrzeżone. Program ten oraz towarzyszące mu materiały są udostępniane na warunkach
licencji EPL (Eclipse Public License), wersja 1.0, dołączonej do nich i
dostępnej pod adresem http://www.eclipse.org/legal/epl-v10.html.