Průvodci vytvořením

org.eclipse.ui.newWizards

Tento bod rozšíření se používá k registraci rozšíření průvodců vytvořením prostředků. Průvodci vytvořením se zobrazují jako volby v položce "Nový dialog" a běžně se používají k vytváření složek a souborů.

V položce "Nový dialog" jsou průvodci uspořádáni do kategorií, které obvykle odpovídají doméně konkrétního problému. Například modul plug-in orientovaný na prostředí Java může definovat kategorii s názvem "Java", která je vhodná pro průvodce vytvořením prvků "Třída" nebo "Balíček". Na kategorie definované jedním modulem plug-in mohou odkazovat ostatní moduly plug-in pomocí atributu kategorie (category). Průvodci nezařazení do kategorií a také průvodci s neplatnou cestou ke kategorii skončí v kategorii "Ostatní".

Průvodci mohou volitelně uvádět popisný dílčí prvek, jehož tělo by mělo obsahovat krátký text o průvodci.

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

Volitelný dílčí prvek, jehož tělo obsahuje krátký text, popisující, co průvodce provede při spuštění.



<!ELEMENT selection EMPTY>

<!ATTLIST selection

class CDATA #REQUIRED

name  CDATA #IMPLIED>


<!ELEMENT primaryWizard EMPTY>

<!ATTLIST primaryWizard

id CDATA #REQUIRED>

Prostředky deklarace, že průvodce je v uživatelském rozhraní jako "primární". Primární průvodce je zvýrazněn v dialogovém okně nového průvodce. Pamatujte, že tento prvek není určen k použití vývojářům modulů plug-in! Tento prvek existuje proto, aby manažeři produktů mohli zvýraznit množinu průvodců pro svoje produkty.



Následuje příklad konfigurace průvodce vytvořením:

   

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

Vytvořit jednoduchý artefakt XYZ a nastavit počáteční obsah

</description>

<selection class=

"org.eclipse.core.resources.IResource"

/>

</wizard>

</extension>

Hodnota atributu třídy musí reprezentovat třídu, která implementuje org.eclipse.ui.INewWizard. Pokud je průvodce vytvořen z položky Nový průvodce, bude vložen do stávajícího průvodce. Pokud je průvodce spuštěn jako zástupce (z nabídky nového souboru nebo tlačítka panelu nástrojů), zobrazí se osamoceně jako samostatné dialogové okno.

Pracovní plocha se dodává s průvodci pro vytváření prázdných prostředků následujících typů: projekt, složka a soubor. Tito průvodci jsou registrováni pomocí stejného mechanizmu, jaký je popsán výše. Mohou se zobrazit také další průvodci dle konkrétní instalace platformy.