Áttekintő-elemkiterjesztés
Azonosító:
org.eclipse.ui.cheatsheets.cheatSheetItemExtension
Minimális verziószám:
3.0
Leírás:
Ezt a kiterjesztési
pontot akkor kell használni, ha egy extra gombot kell hozzáadni az
áttekintő egyik lépéséhez. Az áttekintő-tartalomfájl "item" címkéjéhez
hozzáadható egy új attribútum, és ha az áttekintő-keretrendszer olvassa
ezt az értéket, akkor ellenőrzi, hogy a kiterjesztési ponton keresztül
van-e bejegyezve egy osztály, amely kezeli az attribútumot. Az
áttekintő-tartalomfájlban található attribútumnév összevetésre kerül az
összes bejegyzett cheatsheetItemExtension pontmegvalósítás "itemAttribute"
attribútumaiban található összes értékkel.
Ha van egyezés, akkor az attribútum kezelésére meghatározott osztályt
betölti az áttekintő keretrendszer és meghívásra kerül az
áttekintő-tartalomfájlban megadott attribútum kezelésére.
Az item attribútum értelmezése után az osztály elérhető marad az
áttekintő keretrendszer számára. Amikor az elem előállításra kerül az
áttekintő nézetben, az osztály újfent meghívásra kerül, hogy kezelje az
összetevők egy összetételbe (Composite) felvételét. Az összetételbe
felvett elemek megjelennek az áttekintő megfelelő lépésében (jelenleg a
súgóikon mellett). Csak azon lépésben jelennek meg, amelyet az "item"
címke úgy ír le, hogy az attribútum megjelent az
áttekintő-tartalomfájlban. A kiterjesztési pont javasolt felhasználási
terülte egy kisméretű (16x16), rajzos gomb felvétele, amely megnyomásra
megnyit egy párbeszédablakot.
Konfigurációs kód:
<!ELEMENT extension (itemExtension)*>
<!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 itemExtension EMPTY>
<!ATTLIST itemExtension
itemAttribute CDATA #REQUIRED
class CDATA #REQUIRED>
Ezen kiterjesztés segítségével elemek adhatók az áttekintő-lépésekhez. A
kiterjesztési pont segítségével ikonokat és gombokat (pillanatnyilag a
súgóikon mellett) adhat az áttekintő egyik lépéséhez.
Megadhatja az attribútum nevét, amelyet berak az áttekintőelem-címkébe.
Megadhat egy osztályt, amely kezeli az attribútumérték elemzését az
áttekintő-tartalomfájlból, ha az áttekintő betöltésre kerül. Az attribútum
értékének karaktersorozatnak kell lennie. A megadott osztálynak az
org.eclipse.ui.cheatsheets.AbstractItemExtensionElement
osztályt kell továbbszármaztatnia. Az áttekintő-tartalomfájl elemzése és betöltése után a
kiterjesztési pontban megadott osztály újból meghívásra kerül a felületen
keresztül grafikák vagy gombok egy áttekintő-lépéséhez adásához
(pillanatnyilag a súgógomb mellett).
- itemAttribute - Az attribútumértéknek az attribútumnév
karaktersorozat értékének kell lenni, amely bekerül az
áttekintő-tartalomfájl egyik elemcímkéjébe. Ha az attribútumnév
karaktersorozat megegyezik az áttekintő-tartalomfájl item címkéjében
azonosított attribútummal, akkokr a megadott osztály betöltésre és
meghívásra kerül, hogy elemezze az attribútum teljes értékét a w3 DOM
specifikációnak megfelelően. Később is meghívásra kerül, hogy
vezérlőelemeket vegyen fel egy összetételbe (Composite), és a felvett
összetevők (általában rajzok és gombok) meg fognak jelenni az
áttekintőnek az elemhez megadott lépésében (jelenleg a lépés súgóikonja
mellett).
- class - Az
org.eclipse.ui.cheatsheets.AbstractItemExtensionElement
org osztályt továbbszármaztató osztály neve, amely az áttekintő-tartalomfájl ismeretlen attribútumait kezeli és kibővíti az áttekintő lépéseit. Az osztálynak nyilvánosnak kell lennie, és egy nyilvános, egyargumentumú konstruktorral kell rendelkeznie, amelyik argumentumként az attribútumnevet fogadja el (ez egy String
típusú érték).
Példák:
Az alábbiakban
látható a kiterjesztési pont egy példa megvalósítása:
<extension point=
"org.eclipse.ui.cheatsheets.cheatSheetItemExtension"
>
<itemExtension
itemAttribute=
"xyzButton"
class=
"com.example.HandleParsingAndAddButton"
>
</itemExtension>
</extension>
És a kiterjesztés item attribútuma:
<item title=
"XYZ cím"
xyzButton=
"/icon/button.gif"
/>
Figyelje meg, hogy az item címke attribútumának értéke BÁRMI lehet. Azért
lehet bármi, mert az attribútumot elemző osztály a
HandleParsingAndAddButton, amely a jelen példában az /icon/button.gif
karaktersorozatot találja meg az attribútumban. Ezt az információt később
használja fel a GIF fájl betöltéséhez és egy új gomb ikonjaként
felhasználásához.
API-információk:
Az API
részleteivel kapcsolatban tekintse meg az
org.eclipse.ui.cheatsheets.AbstractItemExtensionElement osztály
Javadocját.
Szállított megvalósítás:
Jelenleg
nincs szállított megvalósítás.
Copyright (c) 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.