Oprettelsesguider

org.eclipse.ui.newWizards

Dette udvidelsespunkt bruges til at registrere oprettelsesguideudvidelser. Oprettelsesguider vises som valgmuligheder i dialogboksen "Ny" og bruges typisk til at oprette foldere og filer.

I dialogboksen "Ny" er guiderne opdelt i kategorier, som normalt afspejler et bestemt problemområde. En Java-orienteret plugin kan f.eks. definere en kategori med navnet "Java", som er egnet til "Class"- eller "Package"-oprettelsesguider. Plugins kan bruge kategoriattributten til at referere til kategorier, som er defineret af andre plugins. Ikke-kategoriserede guider samt guider med ugyldige kategoristier ender i kategorien "Andet".

Guider kan angive et beskrivelsesunderelement, som indeholder en kort tekst om guiden.

<!ELEMENT extension (category | wizard | primaryWizard)*>

<!ATTLIST-udvidelse

point CDATA #REQUIRED

id    CDATA #IMPLIED

navn  CDATA #IMPLIED>


<!ELEMENT category EMPTY>

<!ATTLIST category

id             CDATA #REQUIRED

name           CDATA #REQUIRED

parentCategory CDATA #IMPLIED>


<!ELEMENT wizard (description? , selection*)>

<!ATTLIST wizard

id                    CDATA #REQUIRED

name                  CDATA #REQUIRED

icon                  CDATA #IMPLIED

category              CDATA #IMPLIED

class                 CDATA #REQUIRED

project               (true | false)

finalPerspective      CDATA #IMPLIED

preferredPerspectives CDATA #IMPLIED

helpHref              CDATA #IMPLIED

descriptionImage      CDATA #IMPLIED

canFinishEarly        (true | false)

hasPages              (true | false) >


<!ELEMENT description (#PCDATA)>

Et valgfrit underelement, der indeholder en kort tekst, som beskriver, hvad guiden gør, når den startes.



<!ELEMENT selection EMPTY>

<!ATTLIST selection

klasse CDATA #REQUIRED

navn  CDATA #IMPLIED>


<!ELEMENT primaryWizard EMPTY>

<!ATTLIST primaryWizard

id CDATA #REQUIRED>

En metode til at erklære, at en guide er den "primære" i brugergrænsefladen. En primær guide er fremhævet i dialogboksen Ny guide. Bemærk, at dette element ikke bruges af pluginudviklere. Elementet findes for at give produktchefer mulighed for at fremhæve et sæt guider til deres produkter.



Her er et eksempel på et udvidelsespunkt til konfiguration af en oprettelsesguide:

   

<udvidelsespunkt=

"org.eclipse.ui.newWizards"

>

<category id=

"com.xyz.XYZ"

name=

"XYZ-guider"

>

</category>

<category id=

"com.xyz.XYZ.Web"

name=

"Webguider"

parentCategory=

"com.xyz.XYZ"

>

</category>

<wizard id=

"com.xyz.wizard1"

name=

"XYZ-artefakt"

category=

"com.xyz.XYZ/com.xyz.XYZ.Web"

icon=

"./icons/XYZwizard1.gif"

class=

"com.xyz.XYZWizard1"

>

<beskrivelse>

Opret en enkel XYZ-artefakt, og angiv startindholdet

</description>

<selection class=

"org.eclipse.core.resources.IResource"

/>

</wizard>

</extension>

Værdien af attributten class skal repræsentere et navn på en klasse, der implementerer org.eclipse.ui.INewWizard. Hvis guiden oprettes fra dialogboksen Ny guide, bliver den indsat i den eksisterende guide. Hvis guiden startes som en genvej (fra menuen Fil - Ny eller en knap på værktøjslinjen), vises den enkeltstående som en separat dialogboks.

Arbejdsbænken leveres med guider til oprettelse af tomme ressourcer af følgende typer: projekt, folder og fil. Disse guider er registreret vha. samme mekanisme som beskrevet ovenfor. Der kan også blive vist ekstra guider, afhængigt af den enkelte platformsinstallation.