Ohjatut luontitoiminnot
Tunnus:
org.eclipse.ui.newWizards
Kuvaus:
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.
Merkintärakenne:
<!ELEMENT extension (category | wizard | primaryWizard)*>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - kohdelaajennuspisteen tarkka tunnus.
- id - laajennuksen ilmentymän valinnainen tunnus.
- name - laajennuksen ilmentymän valinnainen nimi.
<!ELEMENT category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory CDATA #IMPLIED>
- id - yksilöllinen nimi, jonka avulla voi yksilöidä tämän luokan.
- name - luokan käännettävä nimi, jota käytetään valintaikkunassa.
- parentCategory - toisen luokan polku, jos tämä luokka on tarkoitettu lisättäväksi kyseisen luokan aliluokaksi.
<!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) >
- id - yksilöllinen nimi, jonka avulla voi yksilöidä tämän ohjatun toiminnon.
- name - ohjatun toiminnon käännettävä nimi, jota käytetään valintaikkunassa.
- icon - sen kuvakkeen suhteellinen polku, joka yhdessä ohjatun toiminnon nimen kanssa näkyy
vaihtoehtona luontivalintaikkunassa.
- category - vinoviivoilla eroteltu luokkatunnusten polku. Kunkin polun
osan on oltava tämän tai muun lisäosan avulla aiemmin määritetty kelvollinen
luokkatunnus. Jos tätä arvoa ei ole määritetty, ohjattu toiminto
lisätään Muut-luokkaan.
- class - sen Java-luokan tarkka nimi, joka toteuttaa org.eclipse.ui.INewWizard-liittymän.
- project - valinnainen määrite, joka määrittää, että ohjattu toiminto luo IProject-resurssin.
Lisäksi tämä määrite lisää ohjatun toiminnon Uusi projekti -valintaikkunan vaihtoehdoksi.
- finalPerspective - valinnainen määrite, joka määrittää perspektiivin aktivoitavaksi, kun IProject-resurssin luonti on valmis.
- preferredPerspectives - valinnainen määrite, joka määrittää pilkuilla erotellun perspektiivitunnusten luettelon. Jos tässä luettelossa ei ole käytössä olevaa perspektiiviä, perspektiiviä ei aktivoida, kun IProject-resurssin luonti on valmis.
- helpHref - tämän ohjatun toiminnon yksityiskohtaisen kuvauksen sisältävän ohjeen URL-osoite.
Versiosta 3.0 alkaen.
- descriptionImage - suuri kuvatiedosto, joka voi sisältää tietoja tästä ohjatusta toiminnosta.
Versiosta 3.0 alkaen.
- canFinishEarly - määrittää, voiko ohjatun toiminnon ajaa ilman, että käyttäjälle näytetään sivuja.
- hasPages - määrittää, sisältääkö ohjattu toiminto sivuja.
<!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>
- class - luokan tarkka nimi. Jos kaikki työympäristön valinnan objektit ovat tämän liittymän toteutuksia, valinta välitetään ohjattuun toimintoon. Muussa tapauksessa välitetään tyhjä valinta.
- name - valinnainen nimisuodatin. Työympäristön valinnan objektien on oltava nimisuodattimen mukaisia, jotta ne voidaan välittää ohjattuun toimintoon.
<!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.
- id - ensisijaiseksi määritettävän ohjatun toiminnon tunnus.
Esimerkkejä:
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>
API-tiedot:
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.
Toimitettu toteutus:
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.
Copyright (c) 2002, 2005 IBM Corporation and others.
All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html