Assistants de création

Identificateur : org.eclipse.ui.newWizards

Description : ce point d'extension est utilisé pour enregistrer des extensions d'assistants de création de ressources. Les assistants de création apparaissent en tant qu'options dans la boîte de dialogue Nouveau et sont généralement utilisés pour créer des projets et des fichiers.

Dans la boîte de dialogue Nouveau, les assistants sont organisés en catégories qui reflètent généralement un domaine de problème particulier. Par exemple, un plug-in Java peut définir une catégorie appelée "Java", appropriée aux assistants de création de classe ou de package. Les catégories définies par un plug-in peuvent être référencées par d'autres plug-in à l'aide de l'attribut category. Les assistants sans catégorie, ainsi que ceux dotés de chemins d'accès à une catégorie incorrecte, finissent dans une catégorie "Autre".

En option, les assistants peuvent spécifier un sous-élément de description dont le corps doit contenir un court texte sur l'assistant.

Marques de configuration :

   <!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
     nom                  CDATA #REQUIRED
      icon                  CDATA #IMPLIED
     category              CDATA #IMPLIED
     class                 CDATA #REQUIRED
     project               (true | false)
     finalPerspective      CDATA #IMPLIED
     preferredPerspectives CDATA #IMPLIED
   >

   <!ELEMENT description (#CDATA)>

   sous-élément facultatif dont le corps contient une brève description de ce que l'assistant fait une fois démarré.

   <!ELEMENT selection EMPTY>

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

Exemples : Voici unexemple de configuration d'assistant de création :

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

Informations d'API : la valeur de l'attribut class doit représenter une classe qui implémente org.eclipse.ui.INewWizard. Si l'assistant est créé à partir de Nouveaux assistants, il sera inséré dans l'assistant existant. S'il est lancé comme raccourci (à partir du menu Assistant Nouveau fichier ou d'un bouton de la barre d'outils), il apparaît de manière autonome dans une boîte de dialogue distincte.

Implémentation fournie : le plan de travail est fourni avec des assistants pour la création de ressources vides des types suivants : projet, dossier et fichier. Ces assistants sont enregistrés à l'aide d'un mécanisme identique à celui décrit ci-dessus. D'autres assistants peuvent également apparaître, en fonction de l'installation d'une plateforme particulière.

Copyright (c) 2002, 2003 IBM Corporation and others. All rights reserved. Ce programme et les produits qui l'accompagnent sont fournis sous licence v1.0 associée à cette distribution et disponibles à l'adresse suivante : http://www.eclipse.org/legal/cpl-v10.html