Asistentes de creación

Identificador: org.eclipse.ui.newWizards

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 ámbito 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 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
   > Ejemplos:

A continuación figura un ejemplo de configuración de un 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 XYZ simple y establecer el contenido inicial
          </description>
      </wizard>
   </extension>

Información sobre las API: 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.

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 IBM Corporation y otros 2000, 2002.