Pohledy
Identifikátor:
org.eclipse.ui.views
Popis:
Tento bod rozšíření se používá pro definování dalších pohledů pro
pracovní plochu. Pohled je viditelná komponenta v rámci stránky pracovní plochy. Zpravidla se používá k navigaci v hierarchii informací (jako je např. pracovní prostor), k otevření editoru nebo k zobrazení vlastností aktivního editoru. Uživatel může pohled zobrazit pomocí nabídky Okno > Zobrazit pohled, nebo jej zavřít prostřednictvím lokálního pruhu titulku daného pohledu.
Z důvodu zpřehlednění situace v dialogovém okně zobrazení pohledu by pohledy měly být seskupeny pomocí kategorií.
Konfigurační markup:
<!ELEMENT extension (category | view | stickyView)*>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - Úplný identifikátor cílového bodu rozšíření.
- ID - Nepovinný identifikátor instance rozšíření.
- name - Nepovinný název instance rozšíření.
<!ELEMENT category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory CDATA #IMPLIED>
- id - Jedinečný název, který bude použit k identifikaci této kategorie.
- name - Přeložitelný název, který bude použit v uživatelském rozhraní pro tuto kategorii.
- parentCategory - Volitelná cesta sestávající z Id kategorií oddělených pomocí '/'. Toto umožňuje vytváření hierarchie kategorií.
<!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 - Jedinečný název, který bude použit k identifikaci tohoto pohledu.
- name - Přeložitelný název, který bude použit v uživatelském rozhraní pro tento pohled.
- category - Volitelný atribut sestávající z Id kategorií oddělených pomocí '/'. Každá odkazovaná kategorie musí být deklarována v odpovídajícím prvku kategorie.
- class - Úplný název třídy, která implementuje rozhraní
org.eclipse.ui.IViewPart. Běžnou praxí je vytvořit podtřídu org.eclipse.ui.part.ViewPart,
aby zdědila výchozí funkčnost.
- icon - Vztažný název ikony, která bude přiřazena k danému pohledu.
- fastViewWidthRatio - Šířka uvedená v procentech šířky pracovní plochy, kterou zabere aktivní rychlý pohled.
Musí být definována jako hodnota s pohyblivou řádovou čárkou a ležet mezi hodnotami 0,05 a 0,95.
Pokud není hodnota zadána, bude použit výchozí poměr.
- allowMultiple - Příznak, který označuje, zda je v daném pohledu povoleno vytváření vícenásobných instancí pomocí IWorkbenchPage.showView(String id, String secondaryId). Výchozí nastavení je false.
<!ELEMENT description (#PCDATA)>
Volitelný dílčí prvek, jehož tělo by mělo obsahovat text poskytující krátký popis pohledu.
<!ELEMENT stickyView EMPTY>
<!ATTLIST stickyView
id CDATA #REQUIRED
location (RIGHT|LEFT|TOP|BOTTOM)
closeable (true | false)
moveable (true | false) >
Tzv. strnulý pohled je pohled, který je po otevření standardně zobrazen ve všech perspektivách v rámci okna. Jeho počáteční umístění je určeno příslušným atributem umístění, nicméně uživatel jej může kdykoli přemístit, či zavřít. Použitím tohoto prvku se pro daný pohled pouze vytvoří zástupný symbol, samotný pohled se tím nezobrazí. Při použití tohoto prvku buďte obezřetní, měl by být použit pouze pro ty pohledy, u který je zobrazení ve všech perspektivách skutečně nutné.
Od verze 3.0
- id - Id pohledu, který má být strnulý.
- location - Volitelný atribut, který určuje relativní umístění strnulého pohledu vzhledem k oblasti editoru. Pokud atribut neexistuje, bude pohled umístěn napravo od oblasti editoru.
- closeable - Volitelný atribut, který určuje, zda je možné daný pohled zavřít. Pokud atribut neexistuje, pohled je možné zavřít.
- moveable - Volitelný atribut, který určuje, zda je možné okno daného pohledu přemisťovat. Pokud atribut neexistuje, je okno přemístitelné.
Příklady:
Následuje příklad bodu rozšíření:
<extension point=
"org.eclipse.ui.views"
>
<category
id=
"com.xyz.views.XYZviews"
name=
"XYZ"
/>
<view
id=
"com.xyz.views.XYZView"
name=
"Pohled XYZ"
category=
"com.xyz.views.XYZviews"
class=
"com.xyz.views.XYZView"
icon=
"icons/XYZ.gif"
/>
</extension>
Následuje příklad deklarace strnulého pohledu:
<extension point=
"org.eclipse.ui.views"
>
<stickyView
id=
"com.xyz.views.XYZView"
/>
</extension>
Informace rozhraní API:
Hodnota atributu class musí být úplný název třídy Java implementující org.eclipse.ui.IViewPart. Při definování nového pohledu je běžným postupem vytvoření podtřídy org.eclipse.ui.part.ViewPart.
Dodaná implementace:
Platforma Eclipse nabízí celou řadu standardních pohledů, včetně pohledu Navigátor, Vlastnosti, Osnova a Úlohy. Z pohledu uživatele se tyto pohledy nijak neliší od pohledů, jejichž zdrojem jsou moduly plug-in. Všechny pohledy lze zobrazit z podnabídky "Zobrazit pohled" v nabídce "Okno". Poloha okna pohledu zůstává vždy zachována: při zavření okna pohledu je jeho poloha uložena a při opětovném otevření v rámci téže relace je opět obnovena. Poloha okna zůstává zachována i pro další relace.
Copyright (c) 2002, 2005 IBM Corporation a další.
Všechna práva vyhrazena.
Tento program a doprovodné materiály jsou zpřístupněny za podmínek licence Eclipse Public License
v1.0, která je součástí této distribuce a je k dispozici na adrese
http://www.eclipse.org/legal/epl-v10.html