Assistentes de Criação

Identificador: org.eclipse.ui.newWizards

Descrição: Este ponto de extensão é utilizado para registrar as extensões do recurso do assistente de criação. Os assistentes de criação aparecem como opções dentro do "Novo Diálogo" e, normalmente, são utilizados para criar pastas e arquivos.

Em "Novo Diálogo", os assistentes estão organizados em categorias que normalmente refletem o domínio de um determinado problema. Por exemplo, um plug-in Java orientado pode definir uma categoria chamada "Java", que é adequada para os assistentes de criação "Classe" ou "Pacote". As categorias definidas por um plug-in podem ser referidas por outros plug-ins utilizando o atributo category. Assistentes sem categoria definida, bem como assistentes com caminhos de categoria inválidos terminarão na categoria "Outros".

Assistentes podem opcionalmente especificar um subelemento de descrição cujo corpo deve conter um texto curto sobre o assistente.

Marcação da Configuração:

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

   Um subelemento opcional cujo corpo contém um texto curto que descreve o que o assistente fará ao ser iniciado

   <!ELEMENT selection EMPTY>

   <!ATTLIST selection
      class CDATA #REQUIRED
     name  CDATA #IMPLIED
   >

Exemplos: A seguir, um exemplo de configuração do assistente de criação:

   <extension point="org.eclipse.ui.newWizards"> 
      <category 
        id="com.xyz.XYZ" 
        name="XYZ Wizards"> 
      </category> 
      <category 
        id="com.xyz.XYZ.Web" 
        name="Web Wizards" 
        parentCategory="com.xyz.XYZ"> 
      </category> 
      <wizard 
          id="com.xyz.wizard1" 
          name="XYZ artifact" 
          category="com.xyz.XYZ/com.xyz.XYZ.Web" 
          icon="./icons/XYZwizard1.gif" 
          class="com.xyz.XYZWizard1"> 
          <description> 
              Criar um artefato XYZ simples e definir o conteúdo inicial
          </description> 
           <selection class="org.eclipse.core.resources.IResource"/>          
      </wizard> 
   </extension> 

Informações de API: O valor do atributo class deve representar uma classe que implementa org.eclipse.ui.INewWizard. Se o assistente for criado a partir de Novo Assistente, ele será inserido no assistente existente. Se o assistente for ativado como um atalho (no menu Novo Arquivo ou em um botão da barra de ferramentas), ele aparecerá sozinho como uma caixa de diálogo separada.

Implementação Fornecida: O assistente de trabalho vem com assistentes para criar recursos vazios dos seguintes tipos: projetos, pastas e arquivo. Esses assistentes são registrados utilizando o mesmo mecanismo conforme descrito acima. Assistentes adicionais também podem aparecer, um assunto para uma instalação especial da plataforma.

Copyright (c) 2002, 2003 IBM Corporation e outros. Todos os direitos reservados. Este programa e os materiais que o acompanham são disponibilizados sob os termos da Common Public License v1.0 que acompanha esta distribuição e estão disponíveis no endereço http://www.eclipse.org/legal/cpl-v10.html