Rozszerzenia perspektywy
Identyfikator:
org.eclipse.ui.perspectiveExtensions
Opis:
Ten punkt rozszerzenia
umożliwia rozszerzanie perspektyw zarejestrowanych przez inne moduły dodatkowe.
Perspektywa definiuje początkową treść pasków działań okna (menu i paska
narzędzi) oraz początkowy zestaw widoków i ich układ na stronie środowiska
roboczego. Inne moduły dodatkowe mogą dodawać do perspektywy akcje lub widoki,
które są wyświetlane po wybraniu perspektywy. Opcjonalne dodatki pochodzące od
innych modułów dodatkowych są dopisywane do definicji początkowej.
Znaczniki konfiguracji:
<!ELEMENT extension (perspectiveExtension*)>
<!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 perspectiveExtension (actionSet | viewShortcut | perspectiveShortcut | newWizardShortcut | view | showInPart)*>
<!ATTLIST perspectiveExtension
targetID CDATA #REQUIRED>
- targetID - unikalny identyfikator perspektywy (podanej w rejestrze), której dotyczy uzupełnienie.
<!ELEMENT actionSet EMPTY>
<!ATTLIST actionSet
id CDATA #REQUIRED>
- id - unikalny identyfikator zestawu akcji, który zostanie dodany do perspektywy.
<!ELEMENT viewShortcut EMPTY>
<!ATTLIST viewShortcut
id CDATA #REQUIRED>
- id - unikalny identyfikator widoku, który zostanie dodany do podmenu Pokaż widok w menu Okna perspektywy.
<!ELEMENT perspectiveShortcut EMPTY>
<!ATTLIST perspectiveShortcut
id CDATA #REQUIRED>
- id - unikalny identyfikator perspektywy, która zostanie dodana do podmenu Otwórz perspektywę w menu Okna perspektywy.
<!ELEMENT newWizardShortcut EMPTY>
<!ATTLIST newWizardShortcut
id CDATA #REQUIRED>
- id - unikalny identyfikator nowego kreatora, który zostanie dodany do podmenu Nowy w menu Plik perspektywy.
<!ELEMENT showInPart EMPTY>
<!ATTLIST showInPart
id CDATA #IMPLIED>
- id - unikalny identyfikator widoku, który zostanie dodany do okna zachęty Pokaż w (menu Nawigacja perspektywy).
<!ELEMENT view EMPTY>
<!ATTLIST view
id CDATA #REQUIRED
relative CDATA #IMPLIED
relationship (stack|left|right|top|bottom|fast)
ratio CDATA #IMPLIED
visible (true | false)
closeable (true | false)
moveable (true | false)
standalone (true | false)
showTitle (true | false) >
- id - unikalny identyfikator widoku, który zostanie dodany do układu perspektywy.
- relative - unikalny identyfikator widoku już istniejącego w perspektywie.
Będzie on stanowić punkt odniesienia przy umieszczaniu nowego
widoku. Związek między tymi dwoma widokami jest określony argumentem
relationship. Ignorowany, jeśli związek ma wartość fast.
- relationship - określa związek między argumentami id i
relative. Obsługiwane są następujące wartości:
fast - rozszerzenie widoku zostanie utworzone jako szybki widok.
stack - rozszerzenie widoku zostanie umieszczone wraz z widokiem
względnym na stosie w folderze.
left, right, top, bottom - rozszerzenie widoku zostanie umieszczone
obok widoku względnego. W takim przypadku należy również zdefiniować atrybut
ratio.
- ratio - procent obszaru w widoku względnym, który zostanie
przeznaczony na rozszerzenie widoku. Jeśli rozszerzenie widoku jest widokiem
szybkim, argument ratio oznacza procent obszaru środowiska roboczego, który
szybki widok zajmie po aktywowaniu. Argument ten należy zdefiniować jako
wartość zmiennopozycyjną z przedziału od 0,05 do 0,95.
- visible - określa, czy początkowo po otwarciu perspektywy widok jest wyświetlany.
W
przypadku użycia atrybut ten powinien mieć wartość true lub false. Jeśli atrybut nie zostanie użyty, początkowo domyślnie widok będzie widoczny.
- closeable - określa, czy widok może być zamknięty w docelowej
perspektywie. W
przypadku użycia atrybut ten powinien mieć wartość true lub false. Jeśli atrybut nie zostanie użyty, widok będzie można zamknąć, chyba że
sama perspektywa jest oznaczona jako stała.
- moveable - określa, czy widok można przenosić. Widoku bez
możliwości przenoszenia nie można przenosić w obrębie tego samego folderu lub
między folderami w perspektywie. W
przypadku użycia atrybut ten powinien mieć wartość true lub false. Jeśli atrybut nie zostanie użyty, widok będzie można przenosić, chyba
że sama perspektywa jest oznaczona jako stała.
- standalone - określa, czy widok jest autonomiczny. Widoku
autonomicznego nie można dokować z innymi widokami w tym samym folderze. W
przypadku użycia atrybut ten powinien mieć wartość true lub false. Atrybut ten
zostanie zignorowany, jeśli atrybut relationship ma wartość fast lub stacked.
Jeśli atrybut nie zostanie użyty, widok będzie
widokiem zwykłym, a nie autonomicznym (wartość domyślna to false).
- showTitle - określa, czy wyświetlany jest tytuł widoku. W
przypadku użycia atrybut ten powinien mieć wartość true lub false. Atrybut
ten odnosi się tylko do widoków autonomicznych. Jeśli atrybut
nie zostanie użyty, tytuł widoku będzie wyświetlany (wartość domyślna to true).
Przykłady:
Poniżej przedstawiono
przykładowe rozszerzenie perspektywy (warto zwrócić uwagę na podelement i
sposób użycia atrybutów):
<extension point=
"org.eclipse.ui.perspectiveExtensions"
>
<perspectiveExtension
targetID=
"org.eclipse.ui.resourcePerspective"
>
<actionSet id=
"org.eclipse.jdt.ui.JavaActionSet"
/>
<viewShortcut id=
"org.eclipse.jdt.ui.PackageExplorer"
/>
<newWizardShortcut id=
"org.eclipse.jdt.ui.wizards.NewProjectCreationWizard"
/>
<perspectiveShortcut id=
"org.eclipse.jdt.ui.JavaPerspective"
/>
<view id=
"org.eclipse.jdt.ui.PackageExplorer"
relative=
"org.eclipse.ui.views.ResourceNavigator"
relationship=
"stack"
/>
<view id=
"org.eclipse.jdt.ui.TypeHierarchy"
relative=
"org.eclipse.ui.views.ResourceNavigator"
relationship=
"left"
ratio=
"0.50"
/>
</perspectiveExtension>
</extension>
W powyższym przykładzie początkowa treść perspektywy zasobów jest
uzupełniana o zestaw akcji, skrót widoku, skrót nowego kreatora i skrót
perspektywy. Ponadto eksplorator pakietów jest umieszczany na nawigatorze
zasobów, a widok hierarchii typu - dodawany obok nawigatora zasobów.
Informacje o interfejsie API:
Elementy zdefiniowane w rozszerzeniu perspektywy są dodawane do początkowej
treści perspektywy docelowej. Następnie użytkownik może usuwać dowolne
obiekty dodatkowe lub dodawać tego rodzaju obiekty przy użyciu interfejsu
użytkownika środowiska roboczego.
Copyright (c) 2002, 2004 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.