Nézetek
Azonosító:
org.eclipse.ui.views
Leírás:
Ez a kiterjesztési pont
a munkaterület további nézeteinek megadására szolgál. A nézetek a munkaterület-oldalak vizuális összetevői. Jellemzően egy
információs hierarchiában navigálásra szolgálnak (mint a munkaterület),
egy szerkesztő megnyitására vagy az aktív szerkesztő tulajdonságainak
megjelenítésére. A felhasználó a nézetet az Ablak > Nézet megjelenítése
menüből teheti láthatóvá, illetve a nézet helyi címsorából zárhatja be.
A Nézet megjelenítése párbeszédablak zsúfoltságának csökkentése érdekében
a nézeteket célszerű kategóriák szerint csoportosítani.
Konfigurációs kód:
<!ELEMENT extension (category | view | stickyView)*>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - a cél kiterjesztési pont teljes képzésű azonosítója
- id - a kiterjesztéspéldány elhagyható azonosítója
- name - a kiterjesztéspéldány elhagyható neve
<!ELEMENT category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory CDATA #IMPLIED>
- id - a kategória azonosítására szolgáló egyedi név
- name - a kategória felhasználói felületén használt, lefordítható név
- parentCategory - '/' karakterekkel elválasztott kategóriaazonosítókból álló, elhagyható elérési út.
Ez lehetővé teszi a kategóriák hierarchiájának létrehozását.
<!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 - a nézet azonosítására szolgáló egyedi név
- name - a nézet felhasználói felületén használt, lefordítható név
- category - '/' karakterekkel elválasztott kategóriaazonosítókból álló, elhagyható attribútum.
Minden hivatkozott kategóriát meg kell adni egy megfelelő kategóriaelemben.
- class - az org.eclipse.ui.IViewPart felületet megvalósító osztály teljes képzésű neve. A
szokásos gyakorlat az org.eclipse.ui.part.ViewPart osztály továbbszármaztatása, az alapértelmezett funkcionalitás öröklése érdekében.
- icon - a nézethez rendelt ikon relatív neve.
- fastViewWidthRatio - a munkaasztal szélességének százalékos aránya, amelyet a nézet aktív gyorsnézetként elfoglal.
Ezt egy 0.05 és 0.95 közötti lebegőpontos értékként kell megadni.
Ha nincs megadva érték, a az alapértelmezett arány kerül felhasználásra.
- allowMultiple - jelző, amelyik azt mutatja, hogy a nézetből készíthető-e több példány az IWorkbenchPage.showView(String id, String secondaryId) segítségével. Az alapértelmezett érték a hamis.
<!ELEMENT description (#PCDATA)>
egy elhagyható részelem, amelynek törzsének a nézetet röviden leíró szöveget kell tartalmaznia.
<!ELEMENT stickyView EMPTY>
<!ATTLIST stickyView
id CDATA #REQUIRED
location (RIGHT|LEFT|TOP|BOTTOM)
closeable (true | false)
moveable (true | false) >
A ragadós nézetek olyanok, amelyek megnyitás után az összes perspektívában megjelennek.
A kezdeti elhelyezkedésüket a location attribútum szabályozza, de semmi
sem gátolja azt, hogy a felhasználó bezárja vagy áthelyezze őket. Az elem
használata csak egy helykitöltőt hoz létre a nézethez, magát a nézetet
nem jeleníti meg. Ezt az elemet igen óvatosan kell használni, és csak
azon nézetekre szabad alkalmazni, amelyeknek valóban létezniük kell
többféle perspektívában is.
A 3.0 óta.
- id - a ragadóssá tenni kívánt nézet neve.
- location - a ragadós nézet helyét a szerkesztőterülethez képest relatívan megadó, elhagyható attribútum. Ha hiányzik, akkor a nézet a szerkesztőterület jobb oldalára lesz dokkolva.
- closeable - elhagyható attribútum, azt jelzi, hogy a nézet bezárható-e. Ha hiányzik, akkor a nézet bezárható.
- moveable - elhagyható attribútum, azt jelzi, hogy a nézet mozgatható-e. Ha hiányzik, akkor a nézet mozgatható.
Példák:
Az alábbiakban bemutatunk egy példát a kiterjesztési pontra:
<extension point=
"org.eclipse.ui.views"
>
<category
id=
"com.xyz.views.XYZviews"
name=
"XYZ"
/>
<view
id=
"com.xyz.views.XYZView"
name=
"XYZ nézet"
category=
"com.xyz.views.XYZviews"
class=
"com.xyz.views.XYZView"
icon=
"icons/XYZ.gif"
/>
</extension>
Az alábbiakban bemutatunk egy példát egy ragadós nézet deklarációjára:
<extension point=
"org.eclipse.ui.views"
>
<stickyView
id=
"com.xyz.views.XYZView"
/>
</extension>
API-információk:
A
class attribútum értéke az
org.eclipse.ui.IViewPart felületet megvalósító osztály teljes
képzésű neve kell, hogy legyen. Új nézet készítésekor a szokásos gyakorlat
az org.eclipse.ui.part.ViewPart osztály továbbszármaztatása.
Szállított megvalósítás:
Az
Eclipse platform számos szabványos nézetet biztosít, mint például a
Navigátor, a Tulajdonságok, a Vázalt és a Feladatok. A felhasználó
szempontjából ezek a nézetek semmiben nem különböznek a bedolgozók
által biztosított nézetektől. Minden nézet megjeleníthető az Ablak menü
Nézetek megjelenítése menüpontjával. A nézet pozíciója
perzisztens: elmentésre kerül a nézet bezárásakor és visszaállításra
kerül, ha ugyanazon a munkameneten belül újra megnyitják a nézetet. A pozíció az egyes munkaterület-munkamenetek között is megmarad.
Copyright (c) 2002, 2005 IBM Corporation és mások.
Minden jog fenntartva. Jelen program és annak kísérőanyagai a csomaghoz
tartozó, illetve a
http://www.eclipse.org/legal/epl-v10.html
címen is elérhető Eclipse Public License 1.0 verziójának hatálya alatt lettek
közzétéve.