Jukselappinnhold

org.eclipse.ui.cheatsheets.cheatSheetContent

3.0

Dette utvidelsespunktet blir brukt til å registrere jukselappinnholdsbidrag. Jukselapper blir vist som valg på "Hjelp"-menyen eller i visningen for jukselappen, og de blir vanligvis brukt for å hjelpe brukeren med å oppnå et overordnet mål gjennom å utføre en rekke komplekse oppgaver.

Jukselappene er organisert i kategorier som vanligvis viser et bestemt problemdomene. En Java-orientert plugin-modul kan for eksempel definere en kategori som heter "Java", som passer til jukselapper som hjelper en bruker med et av Java-verktøyene. Kategoriene som er definert av en plugin-modul, kan refereres til av andre plugin-moduler som bruker kategoriattributtet til et jukselappelement. Jukselapper som ikke er kategorisert, og jukselapper med ugyldige kategoribaner, blir plassert i kategorien "Annen".

Jukselapper kan eventuelt oppgi et underelement med en beskrivelse, der hoveddelen inneholder en kort tekst om jukselappen.

<!ELEMENT extension (category | cheatsheet | taskEditor | taskExplorer)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT category EMPTY>

<!ATTLIST category

id             CDATA #REQUIRED

name           CDATA #REQUIRED

parentCategory CDATA #IMPLIED>

Et kategorielement i cheatsheetContent-utvidelsespunktet oppretter en ny kategori på jukselappmenyen. Jukselappmenyen er tilgjengelig fra Hjelp-menyen på arbeidsbenken. Hvis en ny kategori blir oppgitt, kan jukselapper brukes som mål for den kategorien, slik at de blir vist under kategorien i dialogboksen Jukselappvalg.



<!ELEMENT cheatsheet (description?)>

<!ATTLIST cheatsheet

id          CDATA #REQUIRED

name        CDATA #REQUIRED

category    CDATA #IMPLIED

contentFile CDATA #IMPLIED

listener    CDATA #IMPLIED

composite   (true | false) "false">

Et jukselappelement blir lagt inn i cheatsheetContent-utvidelsespunktet hvis det er en jukselapp som skal legges til på arbeidsbenken. Et jukselappelement må oppgi en ID, et oversettbart navn som skal vises i valgalternativene, en kategori-ID som skal oppgi hvilken kategori denne jukselappen skal inkluderes i, og en innholdsfil. Jukselappens innholdsfil er en XML-fil som beskriver trinnene og handlingene som jukselappen har.



<!ELEMENT description (#PCDATA)>

en kort beskrivelse av jukselappen



<!ELEMENT taskEditor EMPTY>

<!ATTLIST taskEditor

id    CDATA #REQUIRED

class CDATA #REQUIRED

icon  CDATA #REQUIRED>

Dette utvidelsespunktet er midlertidig og bygger på den midlertidige API-klassen TaskEditor. taskEditor-utvidelsespunktet gjør det mulig å vise et tilpasset brukergrensesnitt i redigeringsruten til en sammensatt jukselapp. En oppgave i en sammensatt jukselapp med en type som samsvarer med IDen til dette utvidelsespunktet, vil bruke klassen som er definert i dette utvidelsespunktet, til å opprette redigeringsområdet.



<!ELEMENT taskExplorer EMPTY>

<!ATTLIST taskExplorer

id    CDATA #REQUIRED

class CDATA #IMPLIED

icon  CDATA #IMPLIED

name  CDATA #REQUIRED>

Dette utvidelsespunktet er midlertidig og bygger på den midlertidige API-klassen TaskExplorer. Dette utvidelsespunktet gjør det mulig med bidrag fra en oppgaveutforsker som blir brukt ved åpning av en sammensatt jukselapp.



Nedenfor finner du et eksempel på bruk av utvidelsespunktet cheatSheetContent.

<extension point=

"org.eclipse.ui.cheatsheets.cheatSheetContent"

>

<category name=

"Example category"

id=

"com.example.category"

>

</category>

<cheatsheet name=

"Example cheat sheet"

category=

"com.example.category"

id=

"com.example.cheatSheet"

contentFile=

"ExampleCheatSheet.xml"

>

<description>

Dette er en beskrivelsestekst for min jukselappbeskrivelse.

</description>

</cheatsheet>

</extension>

Du finner mer informasjon i spesifikasjonene til API-pakken org.eclipse.ui.cheatsheets.

Det er ingen innebygde jukselapper.