Ohjatut luontitoiminnot

org.eclipse.ui.newWizards

Tämän laajennuspisteen avulla rekisteröidään ohjattujen resurssien luontitoimintojen laajennuksia. Ohjatut luontitoiminnot näkyvät Uusi valintaikkuna -valikon vaihtoehtoina, ja niiden avulla luodaan kansioita ja tiedostoja.

Ohjatut toiminnot on järjestetty Uusi valintaikkuna -valikossa luokkiin, jotka yleensä vastaavat tiettyjä ongelma-alueita. Esimerkiksi Java-lisäosa voi määrittää Java-luokan, joka puolestaan liittyy ohjattuihin toimintoihin, joilla luodaan luokkia ja paketteja. Yhden lisäosan määrittämiin luokkiin voi viitata muissa lisäosissa luokkamääritettä käyttämällä. Ohjatut toiminnot, joita ei ole luokiteltu tai joiden luokkapolut ovat virheelliset, sijoitetaan Muut-luokkaan.

Ohjatuissa toiminnoissa voi olla description-alielementti, jonka runko-osa on ohjattua toimintoa kuvaava teksti.

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

Valinnainen alielementti, jonka runko-osa sisältää lyhyen tekstikuvauksen ohjatun toiminnon toiminnasta.



<!ELEMENT selection EMPTY>

<!ATTLIST selection

class CDATA #REQUIRED

name  CDATA #IMPLIED>


<!ELEMENT primaryWizard EMPTY>

<!ATTLIST primaryWizard

id CDATA #REQUIRED>

Ohjatun toiminnon määritys käyttöliittymän ensisijaiseksi ohjatuksi toiminnoksi. Ensisijainen ohjattu toiminto näkyy korostettuna uusien ohjattujen toimintojen valintaikkunassa. Tätä elementtiä ei ole tarkoitettu lisäosien kehittäjien käyttöön. Tämän elementin avulla tuotteiden pääkäyttäjät voivat korostaa ohjattuja toimintoja tuotteissaan.



Seuraavassa on ohjatun luontitoiminnon esimerkkikokoonpano:

   

<extension point=

"org.eclipse.ui.newWizards"

>

<category id=

"com.xyz.XYZ"

name=

"Ohjatut XYZ-toiminnot"

>

</category>

<category id=

"com.xyz.XYZ.Web"

name=

"Ohjatut Web-toiminnot"

parentCategory=

"com.xyz.XYZ"

>

</category>

<wizard id=

"com.xyz.wizard1"

name=

"XYZ-artefakti"

category=

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

icon=

"./icons/XYZwizard1.gif"

class=

"com.xyz.XYZWizard1"

>

<kuvaus>

XYZ-perusartefaktin luonti ja perussisällön määritys

</description>

<selection class=

"org.eclipse.core.resources.IResource"

/>

</wizard>

</extension>

Class-määritteen arvon on vastattava luokkaa, joka toteuttaa org.eclipse.ui.INewWizard-liittymän. Jos ohjattu toiminto luodaan Uusi ohjattu toiminto -toiminnon avulla, se lisätään olemassa olevaan ohjattuun toimintoon. Jos ohjattu toiminto on aloitettu pikatoimintona (valitsemalla valikosta Tiedosto > Uusi tai napsauttamalla työkalurivin painiketta), se tulee näkyviin erilliseen valintaikkunaan.

Työympäristössä toimitetaan ohjattuja toimintoja, joiden avulla voi luoda tyhjiä projekti-, kansio- ja tiedostoresursseja. Nämä ohjatut toiminnot on rekisteröity edellä kuvattujen menetelmien mukaisesti. Käyttöympäristöasennus voi sisältää muitakin ohjattuja toimintoja.