Utvidelse av jukselappelement

org.eclipse.ui.cheatsheets.cheatSheetItemExtension

3.0

Du bør bruke dette utvidelsespunktet hvis du trenger å legge til en ekstra knapp i et trinn på jukselappen. Du kan legge inn et nytt attributt i "item"-koden i jukselappens innholdsfil, og når verdien blir lest av jukselappens rammeverk, vil det kontrollere om det er en klasse registrert via dette utvidelsespunktet som skal behandle dette attributtet. Attributtnavnet i jukselappens innholdsfil sammenliknes med alle verdiene i "itemAttribute"-attributtet til alle de registrerte implementeringene av cheatsheetItemExtension-punktet. Hvis det er samsvar, blir klassen som skal behandle dette elementattributtet, lastet inn av jukselappens rammeverk og kalt opp for å behandle attributtet oppgitt i jukselappens innholdsfil. Når klassen har analysert verdien av elementattributtet, er klassen fortsatt tilgjengelig for jukselappens rammeverk. Når elementet blir vist i jukselappvisningen, blir klassen kalt opp på nytt for å behandle tilføying av komponenter i en kompositt. Elementene som blir lagt til i denne kompositten, blir vist i jukselapptrinnet (for øyeblikket ved siden av hjelpeikonet). Det blir bare vist for trinnet som er beskrevet av "item"-koden som attributtet ble vist i, i jukselappens innholdsfil. Vi foreslår at dette utvidelsespunktet blir brukt til å legge til en liten knapp (16x16) med grafikk som åpner en dialogboks når den velges.

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

Bruk denne elementutvidelsen til å legge til elementer i trinn i jukselappen. Du kan bruke dette utvidelsespunktet for å legge til ikoner og knapper (for øyeblikket ved siden av hjelpikonet) i et trinn i jukselappen. Du oppgir navnet på et attributt som du vil legge inn i jukselappens elementkode. Du kan også oppgi en klasse som skal behandle analyseringen av attributtverdien fra jukselappens innholdsfil når jukselappen lastes inn. Attributtverdien må være en streng. Den oppgitte klassen må opprette en subklasse av org.eclipse.ui.cheatsheets.AbstractItemExtensionElement. Når jukselappens innholdsfil er analysert og lastet inn, blir klassen som er oppgitt i utvidelsespunktet, kalt opp på nytt via grensesnittet for å legge til grafikk eller knapper i trinnet i jukselappen (for øyeblikket ved siden av hjelpeknappen).



Her er et eksempel på en implementering av dette utvidelsespunktet:

<extension point=

"org.eclipse.ui.cheatsheets.cheatSheetItemExtension"

>

<itemExtension itemAttribute=

"xyzButton"

class=

"com.example.HandleParsingAndAddButton"

>

</itemExtension>

</extension>

Og her er elementattributtet for den utvidelsen:

<item title=

"XYZ Title"

xyzButton=

"/icon/button.gif"

/>

Legg merke til at verdien av attributtet i elementkoden kan være HVA SOM HELST. Det kan være hva som helst fordi klassen som analyserer attributtet, er klassen HandleParsingAndAddButton, som i dette eksempelet analyserer en /icon/button.gif-streng fra attributtet. Senere blir den informasjonen brukt til å laste inn gif-filen og bruke den som ikonet for en ny knapp.

Se org.eclipse.ui.cheatsheets.AbstractItemExtensionElement i Javadoc-informasjonen hvis du vil vite mer om APIen.

Det er ikke noe levert implementering for øyeblikket.