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 zusammengefasst, die in der Regel einen bestimmten Problembereich darstellen. Ein Java-orientiertes Plug-in könnte beispielsweise eine Kategorie namens "Java" definieren, die für die Assistenten zur Erstellung von Klassen oder Paketen dienen soll. Auf die Kategorien, die durch ein Plug-in definiert werden, können andere Plug-ins unter Verwendung des Attributs "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 extension (category | wizard)*>

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

   <!ELEMENT description (#CDATA)>

   Ein optionales Unterelement, dessen Hauptteil in einem kurzen Text beschreibt, was der Assistent ausführt, wenn er gestartet wird.

   <!ELEMENT selection EMPTY>

   <!ATTLIST selection
     class CDATA #REQUIRED
     name  CDATA #IMPLIED
   >

Beispiele: Das folgende Beispiel zeigt die Konfiguration eines Erstellungsassistenten.

   <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> 
              Create a simple XYZ artifact and set initial content 
          </description> 
           <selection class="org.eclipse.core.resources.IResource"/>          
      </wizard> 
   </extension> 

API-Informationen: Der Wert des Attributs "class" muss eine Klasse darstellen, die org.eclipse.ui.INewWizard implementiert. Falls der Assistent aus dem Assistenten für neue Ressourcen heraus erstellt wird, wird er in den vorhandenen Assistenten eingefügt. Wird der Assistent als Direktaufruf gestartet (über das Menü "Datei > Neu" oder eine Schaltfläche in der Symbolleiste), wird er eigenständig in einem separaten Dialogfenster 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 (c) 2002, 2003 IBM Corporation und Andere. Alle Rechte vorbehalten. Dieses Programm und sein Begleitmaterial werden gemäß den Bedingungen in der "Common Public License v1.0" zur Verfügung gestellt, die diese Verteilung begleitet und unter "http://www.eclipse.org/legal/cpl-v10.html" abgerufen werden kann.