Kreatory tworzenia

org.eclipse.ui.newWizards

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

W oknie dialogowym Nowy kreatory są zorganizowane w kategorie, które odpowiadają zwykle konkretnym obszarom problemowym. Na przykład wtyczka związana 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 jedną wtyczkę inne wtyczki mogą się odwoływać przy użyciu atrybutu category. Kreatory bez kategorii, a także kreatory z niepoprawnymi ścieżkami kategorii, są umieszczane 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 wtyczek. 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=

"Kreatory XYZ"

>

</category>

<category id=

"com.xyz.XYZ.Web"

name=

"Kreatory 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ę kreatory 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świetlane inne kreatory, zależnie od konkretnej instalacji platformy.