Asistentes de creación

Identificador: org.eclipse.ui.newWizards

Descripción: Este punto de extensión se utiliza para registrar extensiones de asistente de creación de recursos. Los asistentes de creación aparecen como opciones dentro del "New Dialog", y son típicamente utilizados para crear nuevos proyectos, carpetas y archivos.

En el "New Dialog", los asistentes se organizan en categorías que generalmente reflejan el ámbito de un problema en particular.  Por ejemplo, un plug-in orientado a Java puede definir una categoría llamada "Java", lo cual es apropiado para los asistentes de creación "Class" o "Package".  Las categorías definidas por un plug-in pueden referenciarse por otros plug-ins utilizando el atributo category. Los asistentes no categorizados, así como los asistentes con vías de acceso a categorías no válidas, acabarán en la categoría "Other".

Los asistentes pueden especificar opcionalmente un subelemento de descripción cuyo cuerpo debería contener un breve texto acerca del asistente.

Señalamiento 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 vemos un ejemplo de configuración de un asistente de creación:

   <extension point="org.eclipse.ui.newWizards">
      <category
        id="com.xyz.XYZ"
        name="XYZ Wizards">
      </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 del API: El valor del atributo class debe representar una clase que implemente org.eclipse.ui.INewWizard.Si el asistente se crea desde New Wizard será insertado en el asistente ya existente.  Si el asistente es lanzado como atajo (desde el menú File New o desde un botón de la barra de herramientas), aparecerá como un recuadro de diálogo autónomo.

El atributo finalPerspective identifica la perspectiva a activar cuando finaliza la creación del recurso IProject en la clase de asistente. La activación de esta perspectiva deberá interpretarse de acuerdo con las preferencias del entorno de trabajo definidas por IWorkbenchPreferenceConstants.PROJECT_OPEN_NEW_PERSPECTIVE. Podrían ser "abrir en ventana nueva", "abrir en la ventana actual", "sustituir la perspectiva actual", o "no hacer nada". Esto es solamente un consejo, pero alentamos a los desarrolladores a que lean y activen el consejo, o bien pueden llamar al API BasicNewProjectResourceWizard#updatePerspective(IConfigurationElement), que hará el trabajo por ellos.

Implementación suministrada: Supplied Implementation: El entorno de trabajo aporta asistentes para la creación de recursos vacíos de los tipos siguientes: proyecto, carpeta y archivo. Estos asistentes se registran utilizando el mismo mecanismo descrito anteriormente. Pueden asimismo aparecer asistentes adicionales, sometidos a la instalación de plataformas particulares.

Copyright IBM Corp. 2000, 2001.  Reservados todos los derechos.