Kreatorzy tworzenia

org.eclipse.ui.newWizards

Ten punkt rozszerzenia umożliwia rejestrowanie rozszerzeń kreatorów tworzenia zasobów. Kreatorzy tworzenia są wyświetlani jako opcje w oknie dialogowym Nowy i zwykle służą do tworzenia folderów i plików.

W oknie dialogowym Nowy kreatorzy są zorganizowani w kategorie, które odpowiadają zwykle konkretnym obszarom problemowym. Na przykład moduł dodatkowy związany z językiem Java może definiować kategorię pod nazwą Java, która jest odpowiednia dla kreatorów tworzenia zasobów typu Klasa lub Pakiet. Do kategorii zdefiniowanych przez jeden moduł dodatkowy mogą odwoływać się inne moduły przy użyciu atrybutu category. Kreatorzy bez kategorii, a także kreatorzy z niepoprawnymi ścieżkami kategorii, są umieszczani w kategorii Inne.

W kreatorach może być opcjonalnie określony podelement opisu, którego treść powinien stanowić krótki tekst na temat kreatora.

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

Opcjonalny podelement, którego treść stanowi krótki opis działania kreatora po uruchomieniu.



<!ELEMENT selection EMPTY>

<!ATTLIST selection

class CDATA #REQUIRED

name  CDATA #IMPLIED>


<!ELEMENT primaryWizard EMPTY>

<!ATTLIST primaryWizard

id CDATA #REQUIRED>

Umożliwia zadeklarowanie kreatora jako podstawowego w interfejsie użytkownika. Kreator podstawowy jest wyróżniony w oknie dialogowym nowego kreatora. Element ten nie jest przeznaczony do użycia przez programistów modułów dodatkowych. Istnieje on po to, aby menedżerowie produktów mogli wyróżnić pewien zestaw kreatorów na potrzeby swoich produktów.



Poniżej przedstawiono przykładową konfigurację kreatora tworzenia:

   

<extension point=

"org.eclipse.ui.newWizards"

>

<category id=

"com.xyz.XYZ"

name=

"Kreatorzy XYZ"

>

</category>

<category id=

"com.xyz.XYZ.Web"

name=

"Kreatorzy WWW"

parentCategory=

"com.xyz.XYZ"

>

</category>

<wizard id=

"com.xyz.wizard1"

name=

"Artefakt XYZ"

category=

"com.xyz.XYZ/com.xyz.XYZ.Web"

icon=

"./icons/XYZwizard1.gif"

class=

"com.xyz.XYZWizard1"

>

<description>

Utworzenie prostego artefaktu XYZ i ustawianie treści początkowej

</description>

<selection class=

"org.eclipse.core.resources.IResource"

/>

</wizard>

</extension>

Wartość atrybutu class musi być nazwą klasy implementującej interfejs org.eclipse.ui.INewWizard. Jeśli kreator jest tworzony z poziomu nowego kreatora, zostanie wstawiony w istniejącym kreatorze. Jeśli kreator zostanie uruchomiony jako skrót (przy użyciu komendy Nowy z menu Plik lub przycisku paska narzędzi), będzie wyświetlany autonomicznie w osobnym oknie dialogowym.

W środowisku roboczym znajdują się kreatorzy do tworzenia pustych zasobów następujących typów: projekt, folder i plik. Mechanizm rejestrowania tych kreatorów jest identyczny z opisanym powyżej. Mogą być także wyświetlani inni kreatorzy, zależnie od konkretnej instalacji platformy.