Létrehozási varázslók

org.eclipse.ui.newWizards

Ez a kiterjesztési pont szolgál erőforrás-létrehozási varázsló kiterjesztések bejegyzésére. A létrehozási varázslók az Új párbeszédablak választási lehetőségeiként jelennek meg és általában mappák és fájlok létrehozását végzik.

Az Új párbeszédablakban a varázslók kategóriákba vannak szervezve, amelyek jellemzően egy adott problématartományt tükröznek. Például egy Java-orientált bedolgozó definiálhat egy "Java" nevű kategóriát, amely megfelelő az "Osztály" vagy "Csomoag" létrehozási varázslóknak. A bedolgozó által meghatározott kategóriákra más bedolgozók is hivatkozhatnak a category attribútum használatával. A nem kategorizált varázslók, valamint az érvénytelen kategória-útvonallal rendelkező varázslók az "Egyéb" kategóriába kerülnek.

A varázslók opcionálisan megadhatnak egy description (leírás) részelemet, amelynek törzse a varázsló rövid szöveges leírását kell, hogy tartalmazza.

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

Egy elhagyható részelem, amelynek törzse rövid szöveges leírását tartalmazza annak, hogy mit fog csinálni a varázsló, ha elindult



<!ELEMENT selection EMPTY>

<!ATTLIST selection

class CDATA #REQUIRED

name  CDATA #IMPLIED>


<!ELEMENT primaryWizard EMPTY>

<!ATTLIST primaryWizard

id CDATA #REQUIRED>

Egy módszer annak deklarálására, hogy a varázsló "elsődleges" a felhasználói felületen. Az elsődleges varázslók ki vannak emelve az Új varázsló párbeszédablakban. Ne feledje, hogy ezt az elemet nem a bedolgozófejlesztőknek szántuk! Ez az elem azért létezik, hogy a termékmenedzserek kiemelhessék a termék egyes varázslóit.



Az alábbiakban bemutatunk egy példát egy létrehozási varázsló beállítására:

   

<extension point=

"org.eclipse.ui.newWizards"

>

<category id=

"com.xyz.XYZ"

name=

"XYZ Wizards"

>

</category>

<category id=

"com.xyz.XYZ.Web"

name=

"Webes varázslók"

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>

Create a simple XYZ artifact and set initial content

</description>

<selection class=

"org.eclipse.core.resources.IResource"

/>

</wizard>

</extension>

A class attribútum értéke egy, az org.eclipse.ui.INewWizard felületet megvalósító osztály kell, hogy legyen. Ha a varázsló létrehozása az Új varázsló párbeszédablakból történik, akkor beszúrásra kerül a meglévő varázslóba. Ha a varázsló gyorsbillentyűként került indításra (a Fájl/Új menüből, vagy egy eszköztárgombbal), akkor önállóan jelenik meg egy külön párbeszédablakban.

A munkaterület tartalmaz egy sor varázslót az alábbi típusú üres erőforrások létrehozásához: projekt, mappa és fájl. Ezek a varázslók a fentivel megegyező mechanizmussal vannak bejegyezve. További varázslók is megjelenhetnek a telepítési platformtól függően.