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. Ces derniers apparaissent en tant qu'options de la boîte de dialogue Nouveau et sont généralement utilisés pour créer de nouveaux projets, dossiers et 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-ins à 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 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
   > Exemples :

L'exemple suivant illustre une 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>
      </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.

L'attribut finalPerspective identifie une perspective à activer lorsque la création de la ressource IProject est terminée dans la classe d'assistant. L'activation de cette perspective doit être interprétée en fonction des préférences du plan de travail, définies par IWorkbenchPreferenceConstants.PROJECT_OPEN_NEW_PERSPECTIVE. Ceci peut signifier "ouvrir dans une nouvelle fenêtre", "ouvrir dans la fenêtre courante", "remplacer la perspective courante" ou "ne rien faire". Il ne s'agit là que d'un conseil, mais les développeurs sont encouragés à le lire et à l'activer. Ils peuvent également appeler l'API BasicNewProjectResourceWizard#updatePerspective(IConfigurationElement) qui fera le travail pour eux.

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 IBM Corp. 2000, 2001. Tous droits réservés.