Assistants de création

org.eclipse.ui.newWizards

Ce point d'extension sert à enregistrer des extensions de l'assistant 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-ins à l'aide de l'attribut catégorie. 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.

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

un sous-élément facultatif dont le corps contient une brève description de ce que l'assistant fera au démarrage.



<!ELEMENT selection EMPTY>

<!ATTLIST selection

class CDATA #REQUIRED

name  CDATA #IMPLIED>


<!ELEMENT primaryWizard EMPTY>

<!ATTLIST primaryWizard

id CDATA #REQUIRED>

un moyen de déclarer qu'un assistant est "primaire" dans l'interface utilisateur. Un assistant primaire est mis en évidence dans la nouvelle boîte de dialogue d'assistant. Cet élément n'est pas conçu pour être utilisé par des développeurs de plug-ins. Il est fourni pour que les gestionnaires du produit puissent mettre en évidence une série d'assistants pour leurs produits.



L'exemple ci-dessous illustre la configuration d'un assistant de création :

   

<extension point=

"org.eclipse.ui.newWizards"

>

<category id=

"com.xyz.XYZ"

name=

"Assistant XYZ"

>

</category>

<category id=

"com.xyz.XYZ.Web"

name=

"Assistants Web"

parentCategory=

"com.xyz.XYZ"

>

</category>

<wizard id=

"com.xyz.wizard1"

name=

"Artefact XYZ"

category=

"com.xyz.XYZ/com.xyz.XYZ.Web"

icon=

"./icons/XYZwizard1.gif"

class=

"com.xyz.XYZWizard1"

>

<description>

Créer un artefact XYZ et définir le contenu initial

</description>

<selection class=

"org.eclipse.core.resources.IResource"

/>

</wizard>

</extension>

La valeur de l'attribut class doit correspondre à la classe implémentant 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.

Le plan de travail est fourni avec des assistants pour créer des ressources vides de type 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.