Áttekintő-elemkiterjesztés

org.eclipse.ui.cheatsheets.cheatSheetItemExtension

3.0

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.

<!ELEMENT extension (itemExtension)*>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!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).



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.

Az API részleteivel kapcsolatban tekintse meg az org.eclipse.ui.cheatsheets.AbstractItemExtensionElement osztály Javadocját.

Jelenleg nincs szállított megvalósítás.