Opprettelsesveivisere

org.eclipse.ui.newWizards

Dette utvidelsespunktet blir brukt til å registrere opprettelsesveiviserutvidelser. Opprettelsesveivisere blir vist som valg under "Ny dialogboks", og de blir vanligvis brukt til å opprette mapper og filer.

I "Ny dialogboks" er veivisere 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 "Klasse"- eller "Pakke"-opprettelsesveivisere. Kategoriene som er definert av en plugin-modul, kan refereres til av andre plugin-moduler som bruker kategoriattributtet. Veivisere som ikke er kategorisert, og veivisere med ugyldige kategoribaner, blir plassert i kategorien "Annen".

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

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

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


<!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 valgfritt underelement der hoveddelen består av en kort tekst som beskriver hva veiviseren gjør når den startes



<!ELEMENT selection EMPTY>

<!ATTLIST selection

class CDATA #REQUIRED

name  CDATA #IMPLIED>


<!ELEMENT primaryWizard EMPTY>

<!ATTLIST primaryWizard

id CDATA #REQUIRED>

en måte å deklarere at veiviseren "primært" er i brukergrensesnittet på. En primær veiviser er uthevet i dialogboksen for ny veiviser. Legg merke til at dette elementet ikke skal brukes av utviklere av plugin-moduler. Elementet finnes for at produktansvarlige skal kunne utheve et sett med veivisere for produktene sine.



Nedenfor finner du et eksempel på en opprettelsesveiviserkonfigurasjon.

   

<extension point=

"org.eclipse.ui.newWizards"

>

<category id=

"com.xyz.XYZ"

name=

"XYZ Wizards"

>

</category>

<category id=

"com.xyz.XYZ.Web"

name=

"Web Wizards"

parentCategory=

"com.xyz.XYZ"

>

</category>

<wizard id=

"com.xyz.wizard1"

name=

"XYZ artifact"

category=

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

icon=

"./icons/XYZwizard1.gif"

class=

"com.xyz.XYZWizard1"

>

<description>

Opprett en enkel XYZ-artefakt og definer det første innholdet

</description>

<selection class=

"org.eclipse.core.resources.IResource"

/>

</wizard>

</extension>

Verdien av klasseattributtet må representere en klasse som implementerer org.eclipse.ui.INewWizard. Hvis veiviseren blir opprettet fra Ny veiviser, blir den satt inn i den eksisterende veiviseren. Hvis veiviseren blir startet som en snarvei (fra menyen Fil, Ny(tt) eller en verktøylinjeknapp) blir den vist frittstående som en egen dialogboks.

Arbeidsbenken leveres med veivisere for opprettelse av denne typen tomme ressurser: prosjekt, mappe og fil. Disse veiviserene registreres også ved hjelp av mekanismen som er beskrevet over. Andre veivisere kan også bli vist, avhengig av den bestemte plattforminstallasjonen.