Ohjatut laajennusten luontitoiminnot
Tunniste:
org.eclipse.pde.ui.newExtension
Kuvaus:
Tämän laajennuspisteen avulla voidaan ottaa käyttöön ohjattuja toimintoja, joita käytetään uusien laajennusten luontiin ja muokkaukseen PDE-kehitysympäristöön kuuluvassa lisäosan manifest-tiedoston muokkausohjelmassa. Ohjatut toiminnot pystyvät luomaan yhden laajennuksen tai useita laajennuksia samanaikaisesti, ja ne pystyvät luomaan laajennusten toteutuksessa tarvittavan koodin. Jos ohjattu toiminto on luotu erityisesti jotakin laajennuspistettä varten, on suositeltavaa rekisteröidä myös sitä vastaava ohjattu muokkausohjelmatoiminto. Tätä ohjattua toimintoa käytetään laajennuspisteen muokkaukseen manifest-tiedoston muokkausohjelmassa sen jälkeen, kun se on luotu manifest-tiedostossa.
Merkintärakenne:
<!ELEMENT extension (wizard | category | editorWizard)*>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - kohteena olevan laajennuspisteen tarkka tunnus.
- id - laajennuksen ilmentymän valinnainen tunnus.
- name - laajennuksen ilmentymän valinnainen nimi.
<!ELEMENT wizard (description?)>
<!ATTLIST wizard
id CDATA #REQUIRED
name CDATA #REQUIRED
icon CDATA #IMPLIED
class CDATA #IMPLIED
availableAsShortcut (true | false)
category CDATA #IMPLIED
template CDATA #IMPLIED>
ohjattu toiminto, jonka avulla voidaan luoda uusi laajennus lisäosan manifest-tiedoston muokkausohjelmasta
- id - yksilöllinen nimi, jonka avulla tämä ohjattu toiminto yksilöidään.
- name - käännettävä nimi, jota käytetään tämän ohjatun toiminnon käyttöliittymäesityksessä.
- icon - sen kuvakkeen suhteellinen polku, jota käytetään ohjatun toiminnon visuaaliseen esitykseen.
- class - org.eclipse.pde.ui.IExtensionWizard-rajapinnan toteuttavan luokan tarkennettu nimi. Tämä määrite ja
template
-määrite ovat toisensa pois sulkevia.
- availableAsShortcut - Jos arvona on true, tämä ohjattu toiminto näkyy valikkopalkin ja työkalurivin pikavalikossa.
- category - valinnainen tunnus, joka tekee tästä ohjatusta toiminnosta aiemmin määritetyn luokan jäsenen. Jos luokka on hierarkkinen, pääluokkaan johtavan täydellisen polun määrityksessä tulee käyttää /-merkkiä erottimena.
- template - sen mallipohjan tunnus, joka esitellään muualla laajennuspisteen
org.eclipse.pde.ui.templates
avulla. Jos tunnus määritetään, mallipohja, jolla on määritetty tunnus, paikannetaan ja ohjattu laajennuksen luontitoiminto luodaan mallipohjan avulla. Tämä määrite ja class
-määrite ovat toisensa pois sulkevia.
<!ELEMENT editorWizard (description?)>
<!ATTLIST editorWizard
id CDATA #REQUIRED
name CDATA #REQUIRED
icon CDATA #IMPLIED
class CDATA #REQUIRED
point CDATA #REQUIRED>
ohjattu toiminto, jonka avulla voidaan muokata laajennusta lisäosan manifest-tiedoston muokkausohjelmasta
- id - yksilöllinen nimi, jonka avulla tämä ohjattu toiminto yksilöidään.
- name - käännettävä nimi, jota käytetään tämän ohjatun toiminnon käyttöliittymäesityksessä.
- icon - sen kuvakkeen suhteellinen polku, jota käytetään ohjatun toiminnon visuaaliseen esitykseen.
- class - org.eclipse.pde.ui.IExtensionEditorWizard-rajapinnan toteuttavan luokan tarkennettu nimi.
- point - sen laajennuspisteen tarkka tunnus, jota tämä ohjattu toiminto pystyy muokkaamaan.
<!ELEMENT category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory CDATA #IMPLIED>
- id - yksilöllinen nimi, jonka avulla viitataan tähän luokkaan.
- name - käännettävä nimi, jota käytetään tämän luokan käyttöliittymäesitykseen.
- parentCategory - valinnainen määrite, jota voidaan käyttää luokkahierarkian luontiin.
<!ELEMENT description (#PCDATA)>
Tämän ohjatun toiminnon lyhyt kuvaus.
Esimerkkejä:
Seuraavassa on esimerkki laajennuksesta:
<extension
point=
"org.eclipse.pde.ui.newExtension"
>
<category
name=
"Custom Extensions"
id=
"custom"
>
</category>
<wizard
availableAsShortcut=
"true"
name=
"Simple Java Editor Extension"
icon=
"icons/java_edit.gif"
category=
"generic"
class=
"com.example.xyz.SimpleJavaEditorExtension"
id=
"com.example.xyz.simple"
>
<description>
Tämä ohjattu toiminto luo yksinkertaisen Java-muokkausohjelman
sekä kaikki tarvittavat luokat ja manifest-merkinnät.
</description>
</wizard>
</extension>
API-tiedot:
Tämä laajennuspiste edellyttää org.eclipse.pde.ui.IExtensionWizard-rajapinnan toteuttavaa luokkaa.
Toimitettu toteutus:
PDE-kehitysympäristössä on yleinen ohjattu toiminto, joka luo laajennuspisteitä laajennuspisteen skeeman tietojen perusteella. Lisäksi kaikki mallipohjat, jotka on rekisteröity org.eclipse.pde.ui.templates
-laajennuspisteen avulla PDE-käyttöliittymässä, ovat käytettävissä myös ohjattuina laajennusten luontitoimintoina.
Copyright (c) 2004 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.