Assistentes de Criação

org.eclipse.ui.newWizards

Esse ponto de extensão é utilizado para registrar extensões de assistentes de criação de recursos. 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.

<!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 descrição (#PCDATA)>

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>


<!ELEMENT primaryWizard EMPTY>

<!ATTLIST primaryWizard

id CDATA #REQUIRED>

um meio de declarar que um assistente é "primário" na UI. Um assistente primário é enfatizado no novo diálogo do assistente. Observe que esse elemento não foi planejado para ser utilizado pelos desenvolvedores de plugin! Esse elemento existe para que os gerenciadores de produtos possam enfatizar um conjunto de assistentes para seus produtos.



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>

Create a simple XYZ artifact and set initial content

</description>

<selection class=

"org.eclipse.core.resources.IResource"

/>

</wizard>

</extension>

O valor do atributo de classe deve representar uma classe que implemente 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.

O workbench é fornecido com assistentes para criar recursos vazios dos seguintes tipos: projeto, pasta 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.