Assistentes de Extensão
Identificador:
org.eclipse.pde.ui.newExtension
Descrição:
Este ponto de extensão deve ser utilizado para contribuir assistentes que serão utilizados para criar e editar novas extensões no editor manifest do plug-in do PDE. Os assistentes podem criar uma ou mais extensões ao mesmo tempo, bem como o código necessário para implementar estas extensões. Se um assistente contribuído é criado especificamente para um ponto de extensão específico, é recomendável registrar também um assistente de editor de correspondência. Este assistente será utilizado para editar o ponto de extensão no editor manifest após ser criado no arquivo manifest.
Marcação de Configuração:
<!ELEMENT extension (wizard | category | editorWizard)*>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - um identificador completo do ponto de extensão de destino
- id - um identificador opcional da instância de extensão
- name - um nome opcional da instância de extensão
<!ELEMENT wizard (description?)>
<!ATTLIST wizard
id CDATA #REQUIRED
name CDATA #REQUIRED
icon CDATA #IMPLIED
class CDATA #IMPLIED
availableAsShortcut (true | false)
category CDATA #IMPLIED
template CDATA #IMPLIED>
um assistente que pode ser utilizado para criar uma nova extensão a partir de dentro do editor manifest de plug-in
- id - nome exclusivo que será utilizado para identificar esse assistente.
- name - um nome que será utilizado na representação da UI deste assistente.
- icon - o caminho relativo de um ícone que será utilizado para representar o assistente visualmente.
- class - um nome totalmente qualificado de uma classe que implementa a interface
org.eclipse.pde.ui.IExtensionWizard. Este atributo é mutuamente exclusivo com o atributo
template
.
- availableAsShortcut - Se verdadeiro, este assistente aparecerá em um menu de atalho na barra de menu na barra de ferramentas.
- category - um id opcional que faz deste assistente um membro da categoria definida anteriormente. Se a categoria é uma hierarquia, o caminho total para a categoria pai deve ser especificado utilizando '/' como um delimitador.
- template - um identificador de um gabarito declarado em outra parte utilizando os pontos de extensão
org.eclipse.pde.ui.templates
. Se definido, o gabarito com o id especificado será localizado e o assistente de extensão será criado utilizando o gabarito. Este atributo é mutuamente exclusivo com o atributo class
.
<!ELEMENT editorWizard (description?)>
<!ATTLIST editorWizard
id CDATA #REQUIRED
name CDATA #REQUIRED
icon CDATA #IMPLIED
class CDATA #REQUIRED
point CDATA #REQUIRED>
um assistente que pode ser utilizado para editar uma extensão existente a partir de dentro do editor manifest de plug-in
- id - nome exclusivo que será utilizado para identificar esse assistente.
- name - um nome que será utilizado na representação da UI deste assistente.
- icon - o caminho relativo de um ícone que será utilizado para representar o assistente visualmente.
- class - um nome qualificado de uma classe que implementa a interface org.eclipse.pde.ui.IExtensionEditorWizard.
- point - um identificador totalmente qualificado do ponto de extensão que este assistente é capaz de editar
<!ELEMENT category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory CDATA #IMPLIED>
- id - um nome único que será utilizado para fazer referência a esta categoria
- name - um nome traduzível que será utilizado para apresentar a UI desta categoria
- parentCategory - um atributo opcional que pode ser utilizado para criar a hierarquia da categoria
<!ELEMENT descrição (#PCDATA)>
Uma breve descrição deste assistente.
Exemplos:
A seguir um exemplo da extensão:
<extension
point=
"org.eclipse.pde.ui.newExtension"
>
<category
name=
"Custom Extensions"
id=
"custom"
>
</category>
<wizard
availableAsShortcut=
"true"
name=
"Simple Java Editor Extension"
icon=
"icons/java_edit.gif"
category=
"generic"
class=
"com.example.xyz.SimpleJavaEditorExtension"
id=
"com.example.xyz.simple"
>
<description>
Este assistente cria um editor Java simples com
todas as classes necessárias e marcações manifest.
</description>
</wizard>
</extension>
Informações sobre API:
Este ponto de extensão requer a classe que implementa a interface org.eclipse.pde.ui.IExtensionWizard.
Implementação Fornecida:
O PDE fornece um assistente genérico que cria pontos de extensão com base em informações de esquema de pontos de extensão. Além disso, todos os gabaritos registrados utilizando o ponto de extensão org.eclipse.pde.ui.templates
na UI do PDE também são enganchados como assistentes de extensão individual.
Direitos Autorais (c) 2004 IBM Corporation e outros.
Todos os direitos reservados.
Este programa e os materiais que o acompanham são disponibilizados
sob os termos do Eclipse Public License v1.0 que acompanha esta
distribuição e está disponível no site http://www.eclipse.org/legal/epl-v10.html.