Erstellungsassistenten

Kennung: org.eclipse.ui.newWizards

Beschreibung: An diesem Erweiterungspunkt können Erweiterungen für Assistenten zur Ressourcenerstellung registriert werden. Erstellungsassistenten werden im Dialog "Neu" als Optionen angezeigt und in der Regel zum Erstellen von Ordnern und Dateien eingesetzt.

Im Dialog "Neu" sind die Assistenten in Kategorien aufgeteilt, die gewöhnlich eine bestimmte Aufgabendomäne darstellen. Beispielsweise könnte ein Java-orientiertes Plug-in eine Kategorie namens "Java" definieren, die für Assistenten zur Erstellung von Klassen oder Paketen geeignet ist. Auf die Kategorien, die durch ein Plug-in definiert werden, können andere Plug-ins über das Attribut category verweisen. Nicht kategorisierte Assistenten werden - ebenso wie Assistenten mit ungültigen Kategoriepfaden - der Kategorie "Andere" zugeordnet.

Assistenten können optional ein Unterelement für eine Beschreibung angeben, dessen Hauptteil einen kurzen Text über den Assistenten enthalten sollte.

Konfigurationsbefehle:

   <!ELEMENT category EMPTY>
   <!ATTLIST category
      id             CDATA #REQUIRED
      name           CDATA #REQUIRED
      parentCategory CDATA #IMPLIED
   >

   <!ELEMENT wizard (description)?>
   <!ATTLIST wizard
      id                 CDATA #REQUIRED
      name               CDATA #REQUIRED
      icon               CDATA #IMPLIED
      category           CDATA #IMPLIED
      class              CDATA #REQUIRED
      project            (true | false) #IMPLIED
      finalPerspective   CDATA #OPTIONAL
   >
   <!ELEMENT description (#PCDATA)>    <!ELEMENT selection EMPTY>
   <!ATTLIST selection
      class  CDATA #REQUIRED
      name   CDATA #OPTIONAL
   > Beispiele:

Das folgende Beispiel stellt die Konfiguration eines Erstellungsassistenten dar:

   <extension point="org.eclipse.ui.newWizards">
      <category
        id="com.xyz.XYZ"
        name="XYZ-Assistenten">
      </category>
      <category
        id="com.xyz.XYZ.Web"
        name="Webassistenten"
        parentCategory="com.xyz.XYZ">
      </category>
      <wizard
          id="com.xyz.wizard1"
          name="XYZ-Artefakt"
          category="com.xyz.XYZ/com.xyz.XYZ.Web"
          icon="./icons/XYZwizard1.gif"
          class="com.xyz.XYZWizard1">
          <description>
              Erstellt ein einfaches XYZ-Artefakt und stellt den Anfangsinhalt bereit.
          </description>
      </wizard>
   </extension>

API-Informationen:Der Wert des Attributs class muss eine Klasse sein, die org.eclipse.ui.INewWizard implementiert. Wenn der Assistent aus dem Assistenten für neue Ressourcen heraus erstellt wird, wird er in den vorhandenen Assistenteneingefügt. Wird der Assistent als Direktaufruf (über das Menü "Datei > Neu" oder eine Schaltfläche in der Symbolleiste) gestartet wird, wird er durch ein separates Dialogfenster eigenständig angezeigt.

Bereitgestellte Implementierung: Bei der Auslieferung enthält die Workbench bereits Assistenten für die Erstellung leerer Ressourcen der folgenden Typen: Projekt, Ordner und Datei. Diese Assistenten werden mit demselben Mechanismus registriert, der oben beschrieben wurde. Abhängig von der speziellen Installation der Plattform können weitere Assistenten hinzukommen.

Copyright IBM Corporation und Andere 2000, 2002. Alle Rechte vorbehalten.