Guider för skapande

org.eclipse.ui.newWizards

Den här utökningspunkten används för att registrera utökningar av guider för resursskapande. Guider för resursskapande visas som val i dialogrutan "Nytt" och används vanligen för att skapa mappar och filer.

I dialogrutan "Nytt" ordnas guider i kategorier som vanligen speglar en viss problemdomän. Ett Java-orienterat insticksprogram kan t.ex. definiera en kategori med namnet "Java", vilken är lämplig för "Class"- eller "Package"-guiderna. De kategorier som definieras av ett insticksprogram kan andra insticksprogram hänvisa till, med hjälp av attributet category. Guider som inte kategoriserats och guider med ogiltiga kategorisökvägar, hamnar i kategorin "Other".

Guider kan (valfritt) ange ett beskrivningsdelelement, vars innehållsdel bör innehålla en kort text om guiden.

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

ett valfritt underelement vars innehållsdel ger en kort beskrivning av vad guiden gör när den startas



<!ELEMENT selection EMPTY>

<!ATTLIST selection

class CDATA #REQUIRED

name  CDATA #IMPLIED>


<!ELEMENT primaryWizard EMPTY>

<!ATTLIST primaryWizard

id CDATA #REQUIRED>

ett sätt att deklarera att en guide är "primär" i användargränssnittet. En primär guide betonas i den nya guide-dialogrutan. Observera att elementet inte är avsett att användas av utvecklare av insticksprogram! Elementet finns för att produkthanterare ska kunna betona en uppsättning guider för deras produkter.



Följande är ett exempel på en konfiguration av en guide för skapande:

   

<extension point=

"org.eclipse.ui.newWizards"

>

<category id=

"com.xyz.XYZ"

name=

"XYZ-guider"

>

</category>

<category id=

"com.xyz.XYZ.Web"

name=

"Webbguider"

parentCategory=

"com.xyz.XYZ"

>

</category>

<wizard id=

"com.xyz.wizard1"

name=

"XYZ-testobjekt"

category=

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

icon=

"./icons/XYZwizard1.gif"

class=

"com.xyz.XYZWizard1"

>

<description>

Skapa ett enkelt XYZ-testobjekt och ställ in initialt innehåll

</description>

<selection class=

"org.eclipse.core.resources.IResource"

/>

</wizard>

</extension>

Värdet på class-attributet måste representera en klass som implementerar org.eclipse.ui.INewWizard. Om guiden skapas inifrån den nya guiden infogas den i befintlig guide. Om guiden startas som en genväg (från menyn Arkiv Nytt eller från en knapp i verktygsfältet) visas den fristående som en separat dialogruta.

Arbetsmiljön medföljer guider för att skapa tomma resurser av följande typer: projekt, mapp och fil. Dessa guider registreras med hjälp av samma mekanismer som beskrivits ovan. Ytterligare guider kan också visas, enligt en viss plattformsinstallation.