Descripción: este punto de extensión permite registrar extensiones de asistentes de creación de recursos. Los asistentes de creación aparecen como opciones dentro del "Diálogo Nuevo" y se emplean típicamente para crear carpetas y archivos.
En el "Diálogo Nuevo", los asistentes están organizados por categorías que generalmente reflejan el dominio de un problema en particular. Por ejemplo, un conector orientado a Java puede definir una categoría llamada "Java", que es apropiada para los asistentes de creación de "Clase" o "Paquete". Con el atributo category, los conectores pueden hacer referencia a las categorías definidas por otro conector. Los asistentes que no pertenecen a ninguna categoría, así como los asistentes con vías de acceso a categorías no válidas, acabarán en la categoría "Otras".
Los asistentes pueden especificar opcionalmente un subelemento description cuyo cuerpo debe contener un texto corto que describa el asistente.
Códigos XML de configuración:
<!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)>
subelemento opcional cuyo cuerpo contiene un texto corto que describe qué hará el asistente al iniciarse.
<!ELEMENT selection EMPTY>
<!ATTLIST selection
class CDATA #REQUIRED
name CDATA #IMPLIED
>
<extension point="org.eclipse.ui.newWizards"> <category id="com.xyz.XYZ" name="Asistentes XYZ"> </category> <category id="com.xyz.XYZ.Web" name="Asistentes Web" parentCategory="com.xyz.XYZ"> </category> <wizard id="com.xyz.wizard1" name="Artefacto XYZ" category="com.xyz.XYZ/com.xyz.XYZ.Web" icon="./icons/XYZwizard1.gif" class="com.xyz.XYZWizard1"> <description> Crear un artefacto simple XYZ y establecer el contenido inicial </description> <selection class="org.eclipse.core.resources.IResource"/> </wizard> </extension>
Información sobre las API: el valor del atributo class debe representar una clase que implemente la interfaz org.eclipse.ui.INewWizard. Si el asistente se crea desde dentro de Asistente Nuevo, se insertará en el asistente existente. Si el asistente se lanza como acceso directo (desde el menú Archivo Nuevo o mediante un botón de la barra de herramientas), aparecerá como recuadro de diálogo independiente.
Implementación suministrada: el entorno de trabajo viene con asistentes para crear recursos vacíos de los tipos siguientes: proyecto, carpeta y archivo. Para registrar estos asistentes se utiliza el mismo mecanismo que el descrito más arriba. También pueden aparecer asistentes adicionales, sujetos a la instalación de las plataformas concretas.
Copyright (c) 2002, 2003 IBM Corporation y otros.
Reservados todos los derechos. Este programa y sus materiales adjuntos están disponibles
bajo los términos de la licencia pública común (Common Public License) v1.0 que acompaña a
esta distribución, y está disponible en
http://www.eclipse.org/legal/cpl-v10.html