Perspektívakiterjesztések
Azonosító:
org.eclipse.ui.perspectiveExtensions
Leírás:
Ez a kiterjesztési
pont más bedolgozók által bejegyzett perspektívák kiterjesztésére
szolgál. A perspektívák határozzák meg az ablak tevékenységsorát (menü és
eszköztár), a nézetek kezdeti halmazát, valamint a munkaterület-oldalon
belüli elrendezésüket.
Más bedolgozók is hozzáadhatnak tevékenységeket vagy nézeteket a
perspektívához, amelyek akkor jelennek meg, ha a perspektíva
kiválasztásra kerül. A más bedolgozók kiegészítései hozzáfűzésre
kerülnek a kezdeti meghatározáshoz.
Konfigurációs kód:
<!ELEMENT extension (perspectiveExtension*)>
<!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 perspectiveExtension (actionSet | viewShortcut | perspectiveShortcut | newWizardShortcut | view | showInPart)*>
<!ATTLIST perspectiveExtension
targetID CDATA #REQUIRED>
- targetID - a perspektíva egyedi azonosítója (a nyilvántartásban megadott módon), amelyhez a hozzáadás történik.
<!ELEMENT actionSet EMPTY>
<!ATTLIST actionSet
id CDATA #REQUIRED>
- id - a perspektívához hozzáadott tevékenységkészlet egyedi azonosítója.
<!ELEMENT viewShortcut EMPTY>
<!ATTLIST viewShortcut
id CDATA #REQUIRED>
- id - a perspektíva Ablak menüjének Nézet megjelenítése almenüjéhez adott nézet egyedi azonosítója.
<!ELEMENT perspectiveShortcut EMPTY>
<!ATTLIST perspectiveShortcut
id CDATA #REQUIRED>
- id - a perspektíva Ablak menüjének Perspektíva megnyitása almenüjéhez adott perspektíva egyedi azonosítója.
<!ELEMENT newWizardShortcut EMPTY>
<!ATTLIST newWizardShortcut
id CDATA #REQUIRED>
- id - a perspektíva Fájl menüjének Új almenüjéhez adott új varázsló egyedi azonosítója.
<!ELEMENT showInPart EMPTY>
<!ATTLIST showInPart
id CDATA #IMPLIED>
- id - a perspektíva Navigáció menüjének Megjelenítés ezzel ablakához adott nézet egyedi azonosítója.
<!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 - a perspektívaelrendezéshez hozzáadott nézet egyedi azonosítója.
- relative - a perspektívában már létező nézet egyedi azonosítója. Ez szolgál referenciaként a nézet elhelyezéséhez. A két nézet közötti kapcsolatot adja meg a relationship elem. A rendszer figyelmen kívül hagyja, ha a relationship elem "fast" értékű.
- relationship - az id és a relative nézetek közötti kapcsolatot adja meg. Az alábbi értékek használhatók:
fast - a nézetkiterjesztés gyorsnézetként kerül létrehozásra.
stack - a nézetkiterjesztés és a relative elemmel megadott nézet egymásra kerül egy mappában.
left, right, top, bottom - a nézetkiterjesztés a relative elemmel megadott nézet mellé kerül. Ebben ez esetben meg kell adni a ratio elemet is.
- ratio - a terület aránya a relative elemmel megadott nézeten belül, amelyet megkap a nézetkiterjesztés. Ha a nézetkiterjesztés egy gyorsnézet, akkor azt adja meg, hogy aktívvá válása esetén a munkaterület hány százalékát foglalja el. Ezt egy 0.05 és 0.95 közötti lebegőpontos értékként kell megadni.
- visible - azt jelzi, hogy a perspektíva megnyitásakor a nézet kezdetben látható-e. Ha használatra kerül, az attribútum érték csak "true" vagy "false" lehet. Ha nincs használatban, akkor a nézet alapértelmezés szerint kezdetben látható.
- closeable - azt jelzi, hogy a nézet bezárható-e a célperspektívában. Ha használatra kerül, az attribútum érték csak "true" vagy "false" lehet. Ha nincs használatban, akkor a nézet alapértelmezés szerint bezárható, kivéve, ha a perspektíva maga rögzítettként van megjelölve.
- moveable - azt jelzi, hogy a nézet mozgatható-e. A nem mozgatható nézet nem helyezhető át sem ugyanazon mappán belül, sem a perspektíva mappái között. Ha használatra kerül, az attribútum érték csak "true" vagy "false" lehet. Ha nincs használatban, akkor a nézet alapértelmezés szerint mozgatható, kivéve, ha a perspektíva maga rögzítettként van megjelölve.
- standalone - azt jelzi, hogy a nézet önálló-e. Az önálló nézetek nem rögzíthetők másokhoz ugyanazon mappán belül. Ha használatra kerül, az attribútum érték csak "true" vagy "false" lehet. Az attribútum figyelmen kívül marad, ha a relationship attribútum értéke "fast" vagy "stacked". Ha nincs használatban, akkor a nézet normál nézet lesz, nem önálló (az alapértelmezett érték a "false").
- showTitle - azt jelzi, hogy a nézet címe látható-e. Ha használatra kerül, az attribútum érték csak "true" vagy "false" lehet. Ez az attribútum csak önálló nézetek esetén alkalmazható. Ha nincs használatban, akkor a nézet címsora megjelenik (az alapértelmezett érték a "true").
Példák:
Az alábbiakban
bemutatunk egy példát egy perspektívakiterjesztésre (figyelje meg a
részelemek és az attribútumok használatának módját):
<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>
A fenti példában egy tevékenységkészlet, egy nézet gyorsbillentyű, egy új
varázsló gyorsbillentyű és egy perspektíva gyorsbillentyű kerül
hozzáadásra az Erőforrás perspektíva kezdeti tartalmához.
Ezen felül a Csomagböngésző nézet rákerül az Erőforrás navigátorra, a
Típushierarchia nézet pedig az Erőforrás navigátor mellé.
API-információk:
A
perspektívakiterjesztésben megadott elemek a célperspektíva kezdeti
tartalmához kerülnek hozzáadásra. Ezután a felhasználó
eltávolíthatja bármelyik hozzáadott elemet vagy újakat vehet fel a
perspektívába a munkaterület felhasználói felületén.
Copyright (c) 2002, 2004 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.