Udvidelse til snydearkselement

org.eclipse.ui.cheatsheets.cheatSheetItemExtension

3.0

Dette udvidelsespunkt skal bruges, når der skal tilføjes en ekstra knap til et trin i snydearket. Du kan anbringe en ny attribut i koden "item" i indholdsfilen til snydearket, og når denne værdi læses af snydearksstrukturen, kontrollerer den, om der er en klasse registreret via dette udvidelsespunkt, som behandler attributten. Det attributnavn, der findes i indholdsfilen til snydearket, sammenlignes med de værdier, der findes i attributten "itemAttribute" for alle de registrerede implementeringer af udvidelsespunktet cheatsheetItemExtension. Hvis der findes en match, indlæses den klasse, der er specificeret til at behandle denne elementattribut, af snydearksstrukturen, og klassen kaldes for at behandle den attribut, der er specificeret i indholdsfilen til snydearket. Når klassen har analyseret (parse) værdien af elementattributten, bliver den tilgængelig for snydearksstrukturen. Når elementet gengives for snydearksoversigten, kaldes klassen igen for at behandle tilføjelsen af komponenter til en sammensætning. De elementer, der tilføjes til denne sammensætning, vises i snydearkstrinnet (i øjeblikket ved siden af hjælpeikonen). Den vises kun for det trin, der er beskrevet af koden "item", som attributten blev vist i, i indholdsfilen til snydearket. Det foreslås, at dette udvidelsespunkt anvendes til at tilføje en lille knap (16x16) med grafik, der åbner en dialogboks, når der trykkes på den.

<!ELEMENT extension (itemExtension)*>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

navn  CDATA #IMPLIED>


<!ELEMENT itemExtension EMPTY>

<!ATTLIST itemExtension

itemAttribute CDATA #REQUIRED

class         CDATA #REQUIRED>

Brug denne elementudvidelse til at tilføje elementer til snydearkstrin. Du kan bruge udvidelsespunktet til at tilføje ikoner og knapper (i øjeblikket ved siden af hjælpeikonen) for et trin i snydearket. Du angiver navnet på den attribut, du vil anbringe i snydearkets elementkode. Du angiver også en klasse, der skal behandle analysen (parse) af attributværdien fra indholdsfilen til snydearket, når snydearket indlæses. Attributværdien skal være en streng. Den angivne klasse skal oprette en underklasse af org.eclipse.ui.cheatsheets.AbstractItemExtensionElement. Når indholdsfilen til snydearket er analyseret (parse) og indlæst, kaldes den klasse, der er angivet i udvidelsespunktet, igen via grænsefladen, så der kan tilføjes grafik eller knapper til trinnet i snydearket (i øjeblikket ved siden af hjælpeknappen).



Her er et eksempel på dette udvidelsespunkt:

<udvidelsespunkt=

"org.eclipse.ui.cheatsheets.cheatSheetItemExtension"

>

<itemExtension itemAttribute=

"xyzButton"

class=

"com.example.HandleParsingAndAddButton"

>

</itemExtension>

</extension>

Og her er elementattributten for denne udvidelse:

<item title=

"XYZ Title"

xyzButton=

"/icon/button.gif"

/>

Bemærk, at værdien af attributten i elementkoden kan være hvad som helst. Årsagen er, at den klasse, der analyserer (parse) attributten, er klassen HandleParsingAndAddButton, som i dette eksempel analyser en streng-/icon/button.gif fra attributten. Senere vil den bruge disse oplysninger til at indlæse gif-filen og bruge den som ikon til en ny knap.

I Javadoc-oplysningerne til org.eclipse.ui.cheatsheets.AbstractItemExtensionElement finder du oplysninger om API'et.

Der leveres ingen implementering i øjeblikket.