Asistentes de creación

org.eclipse.ui.newWizards

Este punto de extensión permite registrar extensiones de asistente 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.

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

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>


<!ELEMENT primaryWizard EMPTY>

<!ATTLIST primaryWizard

id CDATA #REQUIRED>

un medio de declarar que un asistente es "primario" en la UI. Un asistente primario se resalta en el diálogo de asistente nuevo. Tenga en cuenta que los desarrolladores de conectores no deben utilizar este elemento. Este elemento existe a fin de que los gestores de productos puedan resaltar un conjunto de asistentes para sus productos.



A continuación figura un ejemplo de configuración asistente de creación:

   

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

El valor del atributo class debe representar una clase que implemente 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.

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.