Assistants d'extension
Identificateur :
org.eclipse.pde.ui.newExtension
Description :
Ce point d'extension doit être utilisé pour offrir une contribution à des assistants qui permettront de créer et d'éditer des extensions dans l'éditeur de manifeste de plug-in PDE. Les assistants peuvent créer une ou plusieurs extensions à la fois, ainsi que le code nécessaire pour implémenter ces dernières. Si un assistant associé est spécifiquement créé pour un point d'extension particulier, il est conseillé d'enregistrer également l'assistant de l'éditeur correspondant. Cet assistant permettra d'éditer le point d'extension dans le fichier manifeste une fois que celui-ci aura été créé dans ce fichier.
Marques de configuration :
<!ELEMENT extension (wizard | category | editorWizard)*>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - identificateur complet du point d'extension cible
- id - identificateur facultatif de l'instance d'extension
- name - nom facultatif de l'instance d'extension
<!ELEMENT wizard (description?)>
<!ATTLIST wizard
id CDATA #REQUIRED
name CDATA #REQUIRED
icon CDATA #IMPLIED
class CDATA #IMPLIED
availableAsShortcut (true | false)
category CDATA #IMPLIED
template CDATA #IMPLIED>
assistant pouvant être utilisé pour créer une extension à partir de l'éditeur de manifeste de plug-in
- id - nom unique utilisé pour identifier cet assistant.
- name - nom traduisible utilisé dans une représentation de cet assistant dans l'interface utilisateur.
- icon - chemin relatif d'une icône utilisé pour représenter visuellement l'assistant.
- class - nom complet d'une classe qui implémente l'interface org.eclipse.pde.ui.IExtensionWizard. Cet attribut et l'attribut
template
s'excluent mutuellement.
- availableAsShortcut - si cette option a la valeur true, cet assistant apparaît dans le menu contextuel de la barre de menus et de la barre d'outils.
- category - id facultatif faisant de cet assistant un membre de la catégorie définie précédemment. Si la catégorie est hiérarchique, le chemin complet de la catégorie parent doit être indiqué en utilisant '/' comme délimiteur.
- template - identificateur d'un modèle déclaré ailleurs à l'aide du point d'extension
org.eclipse.pde.ui.templates
. Si cette option est définie, le modèle doté de l'ID indiqué est trouvé, et l'assistant d'extension est créé à l'aide du modèle. Cet attribut et l'attribut class
s'excluent mutuellement.
<!ELEMENT editorWizard (description?)>
<!ATTLIST editorWizard
id CDATA #REQUIRED
name CDATA #REQUIRED
icon CDATA #IMPLIED
class CDATA #REQUIRED
point CDATA #REQUIRED>
assistant pouvant être utilisé pour modifier une extension à partir de l'éditeur de manifeste de plug-in
- id - nom unique utilisé pour identifier cet assistant.
- name - nom traduisible utilisé dans une représentation de cet assistant dans l'interface utilisateur.
- icon - chemin relatif d'une icône utilisé pour représenter visuellement l'assistant.
- class - nom complet d'une classe qui implémente l'interface org.eclipse.pde.ui.IExtensionEditorWizard.
- point - identificateur complet du point d'extension que cet assistant a la capacité de modifier.
<!ELEMENT
category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory CDATA #IMPLIED>
- id - nom unique utilisé pour référencer cette catégorie
- name - nom traduisible utilisé pour présenter cette catégorie dans l'interface utilisateur
- parentCategory - attribut facultatif pouvant être utilisé pour créer une hiérarchie de catégories
<!ELEMENT description (#PCDATA)>
Brève description de cet assistant.
Exemples :
Voici un exemple illustrant l'extension :
<extension
point=
"org.eclipse.pde.ui.newExtension"
>
<category
name=
"Custom Extensions"
id=
"custom"
>
</category>
<wizard
availableAsShortcut=
"true"
name=
"Simple Java Editor Extension"
icon=
"icons/java_edit.gif"
category=
"generic"
class=
"com.example.xyz.SimpleJavaEditorExtension"
id=
"com.example.xyz.simple"
>
<description>
Cet assistant crée un éditeur Java simple comportant
toutes les classes requises et marques de manifeste.
</description>
</wizard>
</extension>
Informations d'API :
Ce point d'extension requiert une classe qui implémente l'interface org.eclipse.pde.ui.IExtensionWizard.
Implémentation fournie :
PDE fournit un assistant générique qui crée des points d'extension fondés sur les informations du schéma des points d'extension. De plus, tous les modèles enregistrés à l'aide du point d'extension org.eclipse.pde.ui.templates
dans l'interface utilisateur de PDE sont également associés en tant qu'assistants d'extension individuels.
Copyright (c) 2004 IBM Corporation and others.
All rights reserved. Ce programme et les produits qui l'accompagnent sont
distribués sous licence Eclipse v1.0 et disponibles à
l'adresse suivante :
http://www.eclipse.org/legal/epl-v10.html