Opprettelsesveivisere
Identifikator:
org.eclipse.ui.newWizards
Beskrivelse:
Dette utvidelsespunktet blir brukt til å registrere
opprettelsesveiviserutvidelser. Opprettelsesveivisere blir vist som valg under "Ny dialogboks", og de blir
vanligvis brukt til å opprette mapper og filer.
I "Ny dialogboks" er veivisere organisert i kategorier som vanligvis viser et bestemt problemdomene. En
Java-orientert plugin-modul kan for eksempel definere en kategori som heter "Java", som passer til "Klasse"- eller
"Pakke"-opprettelsesveivisere. Kategoriene som er definert av en plugin-modul, kan refereres til av andre
plugin-moduler som bruker kategoriattributtet. Veivisere som ikke er kategorisert, og veivisere med
ugyldige kategoribaner, blir plassert i kategorien "Annen".
Veivisere kan eventuelt oppgi et underelement med en beskrivelse, der hoveddelen inneholder en
kort tekst om veiviseren.
Konfigurasjonskodetype:
<!ELEMENT extension (category | wizard | primaryWizard)*>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - en fullt kvalifisert ID for målutvidelsespunktet
- id - en valgfri ID for utvidelsesforekomsten
- name - et valgfritt navn på utvidelsesforekomsten
<!ELEMENT category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory CDATA #IMPLIED>
- id - et unikt navn som kan brukes til å identifisere denne kategorien
- name - et oversettbart navn for kategorien som skal brukes i dialogboksen
- parentCategory - en bane til en annen kategori hvis denne kategorien skal legges til som en underordnet
<!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 - et unikt navn som kan brukes til å identifisere denne veiviseren
- name - et oversettbart navn for veiviseren som skal brukes i dialogboksen
- icon - en relativ bane for et ikon som skal brukes sammen med navnet for å representere veiviseren som
et av valgene i opprettelsesdialogboksen.
- category - en bane med kategori-IDer med skråsterk ('/') som skilletegn. Hvert symbol i banen må
representere en gyldig kategori-ID som tidligere er definert av denne eller en annen plugin-modul. Hvis den er
utelatt, vil veiviseren bli lagt til i kategorien "Annen".
- class - et fullt kvalifisert navn på Java-klassen som implementerer org.eclipse.ui.INewWizard.
- project - et valgfritt attributt som viser at veiviseren skal opprette en IProject-ressurs.
Fører
også til at veiviseren blir vist som et valg i dialogboksen "Nytt prosjekt".
- finalPerspective - et valgfritt attributt som identifiserer et perspektiv som skal aktiveres når
IProject-ressursopprettelsen er ferdig.
- preferredPerspectives - et valgfritt attributt som oppgir en liste over perspektiv-IDer. Listen bruker
komma som skilletegn. Hvis det gjeldende perspektivet er på listen, forekommer det ikke noe perspektivaktivering
når IProject-ressursen er opprettet.
- helpHref - en hjelpe-URL som kan beskrive denne veiviseren i detalj.
Siden 3.0
- descriptionImage - en større bilde som kan bidra til å beskrive veiviseren.
Siden 3.0
- canFinishEarly - om veiviseren kan fullføres uten noen gang å vise sider til brukeren.
- hasPages - om veiviseren leverer sider.
<!ELEMENT description (#PCDATA)>
et valgfritt underelement der hoveddelen består av en kort tekst som beskriver hva veiviseren gjør når den startes
<!ELEMENT selection EMPTY>
<!ATTLIST selection
class CDATA #REQUIRED
name CDATA #IMPLIED>
- class - et fullt kvalifisert klassenavn. Hvis hvert objekt i arbeidsbenkvalget implementerer dette
grensesnittet, blir valget sendt til veiviseren. Hvis ikke, blir et tomt valg sendt.
- name - et valgfritt navnefilter. Hvert objekt i arbeidsbenkvalget må samsvare med navnefilteret for at
det skal sendes til veiviseren.
<!ELEMENT primaryWizard EMPTY>
<!ATTLIST primaryWizard
id CDATA #REQUIRED>
en måte å deklarere at veiviseren "primært" er i brukergrensesnittet på. En primær veiviser er uthevet i
dialogboksen for ny veiviser. Legg merke til at dette elementet ikke skal brukes av utviklere av
plugin-moduler. Elementet finnes for at produktansvarlige skal kunne utheve et sett med veivisere for produktene
sine.
- id - IDen til en veiviser som skal være primær.
Eksempler:
Nedenfor finner du et eksempel på en
opprettelsesveiviserkonfigurasjon.
<extension point=
"org.eclipse.ui.newWizards"
>
<category
id=
"com.xyz.XYZ"
name=
"XYZ Wizards"
>
</category>
<category
id=
"com.xyz.XYZ.Web"
name=
"Web Wizards"
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>
Opprett en enkel XYZ-artefakt og definer det første innholdet
</description>
<selection class=
"org.eclipse.core.resources.IResource"
/>
</wizard>
</extension>
API-informasjon:
Verdien av klasseattributtet må representere en klasse
som implementerer org.eclipse.ui.INewWizard. Hvis veiviseren blir opprettet fra Ny veiviser, blir den satt inn i den eksisterende veiviseren.
Hvis veiviseren
blir startet som en snarvei (fra menyen Fil, Ny(tt) eller en verktøylinjeknapp) blir den vist frittstående som en
egen dialogboks.
Levert implementering:
Arbeidsbenken leveres med veivisere for
opprettelse av denne typen tomme ressurser: prosjekt, mappe og fil. Disse veiviserene registreres også ved hjelp av
mekanismen som er beskrevet over. Andre veivisere kan også bli vist, avhengig av den bestemte
plattforminstallasjonen.
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