Assistentes de Criação

Identificador: org.eclipse.ui.newWizards

Descrição: Esse 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 são tipicamente utilizados para criar novos projetos, pastas e arquivos.

No "Novo Diálogo", os assistentes são organizados dentro de categorias que geralmente refletem um domínio de problema particular.  Por exemplo, um plug-in orientado para Java pode definir uma categoria chamada "Java" que é apropriada para assistentes de criação "Classe" ou "Pacote".   As categorias definidas pelo plug-in podem ser referidoas 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 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
   > Exemplos:

A seguir um exemplo da 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>
              Cria um artefact XYZ simples e define o conteúdo inicial.
          </description>
      </wizard>
   </extension>

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

O atributo finalPerspective identifica uma perspectiva para ativar quando a criação do recurso IProject estiver terminada dentro da classe do assistente. A ativação dessa perspectiva devem ser interpretadas de acordo com a preferência do workbench definida porIWorkbenchPreferenceConstants.PROJECT_OPEN_NEW_PERSPECTIVE. Isso pode significar "abrir uma nova janela", "abrir na janela atual", "substituir a perspectiva atual " ou "não fazer nada". Isso é somente uma dica, mas desenvolvedores são encorajados a ler e ativar essa dica ou eles podem chamar a api BasicNewProjectResourceWizard#updatePerspective(IConfigurationElement) que fará o trabalho por eles.

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 IBM Corp. 2000, 2001.  Todos os  Direitos Reservados.