Utvidelse av jukselappelement
Identifikator:
org.eclipse.ui.cheatsheets.cheatSheetItemExtension
Siden:
3.0
Beskrivelse:
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.
Konfigurasjonskodetype:
<!ELEMENT extension (itemExtension)*>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - en fullt kvalifisert ID for målutvidelsespunktet
- id - en valgfri ID for utvidelsesforekomsten
- name - et valgfritt navn på utvidelsesforekomsten
<!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).
- itemAttribute - Denne attributtverdien må være strengverdien til et attributtnavn som bli lagt inn i en
elementkode i jukselappens innholdsfil. Hvis denne attributtverdien samsvarer med et attributt som er analysert fra
elementkoden i jukselappens innholdsfil, blir den oppgitte klassen lastet inn og kalt opp for å analysere den
fullstendige verdien av attributtet, ved hjelp av w3 DOM-spesifikasjonen. Den blir senere kalt opp for å legge til
kontroller i en kompositt, og komponentene (vanligvis grafikk eller knapper) som er lagt til, blir vist i trinnet
i jukselappen for det oppgitte elementet (for øyeblikket ved siden av hjelpeikonet til trinnet).
- class - Det fullt kvalifiserte klassenavnet til klassen som oppretter en subklasse av
org.eclipse.ui.cheatsheets.AbstractItemExtensionElement
for å behandle ukjente attributter i
jukselappens innholdsfil og utvide trinnene i jukselappen. Klassen må være felles og ha en felles
1-argumentkonstruktør som godtar attributtnavnet (en String
).
Eksempler:
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.
API-informasjon:
Se
org.eclipse.ui.cheatsheets.AbstractItemExtensionElement i Javadoc-informasjonen hvis du vil vite mer om APIen.
Levert implementering:
Det er ikke noe levert implementering for
øyeblikket.
Copyright (c) 2004, 2006 IBM Corporation and others.
All rights reserved. This program and the accompanying materials are made
available under the terms of the Eclipse Public License v1.0 which
accompanies
this distribution, and is available at
http://www.eclipse.org/legal/epl-v10.html