Udvidelse til snydearkselement
Id:
org.eclipse.ui.cheatsheets.cheatSheetItemExtension
Fra:
3.0
Beskrivelse:
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.
Konfigurationskode:
<!ELEMENT extension (itemExtension)*>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
navn CDATA #IMPLIED>
- point - en fuldstændig id for måludvidelsespunktet.
- id - en valgfri id for udvidelsesforekomsten.
- name - et valgfrit navn på udvidelsesforekomsten.
<!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).
- itemAttribute - denne attributværdi skal være strengværdien af et attributnavn, der anbringes i en elementkode i indholdsfilen til snydearket. Hvis denne attributstreng matcher en attribut, der er fundet ved analyse (parse) af elementkoden i indholdsfilen til snydearket, bliver den angivne klasse indlæst og kaldes, så den kan analysere (parse) den fulde værdi af attributten vha. w3 DOM-specifikationen. Den kaldes senere for at tilføje kontroller til en sammensætning, og de tilføjede komponenter (normalt grafik eller knapper) vises i trinnet på snydearket for det angivne element (i øjeblikket ved siden af hjælpeikonen for det pågældende trin).
- class - det fuldstændige klassenavn på den klasse, der opretter en underklasse af
org.eclipse.ui.cheatsheets.AbstractItemExtensionElement
for at behandle ukendte attributter i indholdsfilen til snydearket og udvide trinnene i snydearket. Klassen skal være offentlig og have en offentlig 1-argumentkonstruktør, der accepterer attributnavnet (String
).
Eksempler:
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.
API-oplysninger:
I Javadoc-oplysningerne til org.eclipse.ui.cheatsheets.AbstractItemExtensionElement finder du oplysninger om API'et.
Leveret implementering:
Der leveres ingen implementering i øjeblikket.
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