Guider för skapande
ID:
org.eclipse.ui.newWizards
Beskrivning:
Den här utökningspunkten används för att registrera utökningar av guider för resursskapande. Guider för resursskapande visas som val i dialogrutan "Nytt" och används vanligen för att skapa mappar och filer.
I dialogrutan "Nytt" ordnas guider i kategorier som vanligen speglar en viss problemdomän. Ett Java-orienterat insticksprogram kan t.ex. definiera en kategori med namnet "Java", vilken är lämplig för "Class"- eller "Package"-guiderna. De kategorier som definieras av ett insticksprogram kan andra insticksprogram hänvisa till, med hjälp av attributet category. Guider som inte kategoriserats och guider med ogiltiga kategorisökvägar, hamnar i kategorin "Other".
Guider kan (valfritt) ange ett beskrivningsdelelement, vars innehållsdel bör innehålla en kort text om guiden.
Konfigurationsmärkordsuppsättning:
<!ELEMENT extension (category | wizard | primaryWizard)*>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - ett fullständigt ID för målutökningspunkten
- id - ett valfritt ID för utökningsförekomsten
- name - ett valfritt namn på utökningsförekomsten
<!ELEMENT category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory CDATA #IMPLIED>
- id - ett unikt namn som kan användas till att identifiera kategorin
- name - ett översättningsbart namn på kategorin som visas i dialogrutan
- parentCategory - en sökväg till en annan kategori om kategorin skulle läggas till som underordnat objekt
<!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 - ett unikt namn som används för att identifiera guiden
- name - ett översättningsbart namn på guiden som visas i dialogrutan
- icon - en relativ sökväg för en ikon som används tillsammans med namnet för att representera guiden som ett av valen i dialogrutan för skapande
- category - en snedstrecksavgränsad sökväg ('/') för kategori-IDn. Varje token i sökvägen måste representera ett giltigt kategori-ID som tidigare definierats av det här eller något annat insticksprogram.
Om det utelämnas läggs guiden till
i kategorin "Övriga".
- class - ett fullständigt namn på den Java-klass som implementerar org.eclipse.ui.INewWizard
- project - ett valfritt attribut som anger att guiden skapar en IProject-resurs.
Gör också att guiden visas som ett val i dialogrutan "Nytt projekt".
- finalPerspective - ett valfritt attribut som identifierar ett perspektiv som aktiveras när resursen IProject har skapats
- preferredPerspectives - ett valfritt attribut som anger en kommaavgränsad lista över perspektiv-IDn. Om aktuellt perspektiv finns med i listan aktiveras inget perspektiv när resursen IProject har skapats.
- helpHref - en hjälpwebbadress som beskriver guiden i detalj
Sedan 3.0
- descriptionImage - en större bild som kan hjälpa till med beskrivningen av guiden
Sedan 3.0
- canFinishEarly - om guiden kan slutföra utan att någonsin ha visat sidor för användaren
- hasPages - om guiden tillhandahåller några sidor
<!ELEMENT description (#PCDATA)>
ett valfritt underelement vars innehållsdel ger en kort beskrivning av vad guiden gör när den startas
<!ELEMENT selection EMPTY>
<!ATTLIST selection
class CDATA #REQUIRED
name CDATA #IMPLIED>
- class - ett fullständigt klassnamn. Om varje objekt i arbetsmiljöurvalet implementerar det här gränssnittet överförs urvalet till guiden. Annars överförs ett tomt urval.
- name - ett valfritt namnfilter. Varje objekt i arbetsmiljöurvalet måste matcha namnfiltret som ska överföras till guiden
<!ELEMENT primaryWizard EMPTY>
<!ATTLIST primaryWizard
id CDATA #REQUIRED>
ett sätt att deklarera att en guide är "primär" i användargränssnittet. En primär guide betonas i den nya guide-dialogrutan. Observera att elementet inte är avsett att användas av utvecklare av insticksprogram! Elementet finns för att produkthanterare ska kunna betona en uppsättning guider för deras produkter.
- id - IDt för en guide som ska göras primär
Exempel:
Följande är ett exempel på en konfiguration av en guide för skapande:
<extension point=
"org.eclipse.ui.newWizards"
>
<category
id=
"com.xyz.XYZ"
name=
"XYZ-guider"
>
</category>
<category
id=
"com.xyz.XYZ.Web"
name=
"Webbguider"
parentCategory=
"com.xyz.XYZ"
>
</category>
<wizard
id=
"com.xyz.wizard1"
name=
"XYZ-testobjekt"
category=
"com.xyz.XYZ/com.xyz.XYZ.Web"
icon=
"./icons/XYZwizard1.gif"
class=
"com.xyz.XYZWizard1"
>
<description>
Skapa ett enkelt XYZ-testobjekt och ställ in initialt innehåll
</description>
<selection class=
"org.eclipse.core.resources.IResource"
/>
</wizard>
</extension>
API-information:
Värdet på class-attributet måste representera en klass som implementerar org.eclipse.ui.INewWizard. Om guiden skapas inifrån den nya guiden infogas den i befintlig guide.
Om guiden startas som en genväg (från menyn Arkiv Nytt eller från en knapp i verktygsfältet) visas den fristående som en separat dialogruta.
Medföljande implementering:
Arbetsmiljön medföljer guider för att skapa tomma resurser av följande typer: projekt, mapp och fil. Dessa guider registreras med hjälp av samma mekanismer som beskrivits ovan. Ytterligare guider kan också visas, enligt en viss plattformsinstallation.
Copyright (c) 2002, 2005 IBM Corporation and others.
All rights reserved. Detta program och medföljande material tillhandahålls under villkoren för Eclipse Public License v1.0 som medföljer denna distribution och finns tillgänglig på
http://www.eclipse.org/legal/epl-v10.html