Assistentes de Extensão
Identificador:
org.eclipse.pde.ui.newExtension
Descrição:
Este ponto de extensão deve ser usado para contribuir com assistentes que, por seu turno, serão utilizados para criar e editar novas extensões no editor de manifestos de 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 as mesmas. Se um assistente que tenha sido um contributo for especificamente criado para determinado ponto de extensão, aconselha-se registar também um assistente de editores correspondente. Este assistente será usado para editar o ponto de extensão no editor de manifestos depois de ter sido criado no ficheiro de manifestos.
Marcação de Configuração:
<!ELEMENT extensão (assistente | categoria | assistenteEditores)*>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - um identificador totalmente qualificado 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 assistente (descrição?)>
<!ATTLIST wizard
id CDATA #REQUIRED
name CDATA #REQUIRED
icon CDATA #IMPLIED
classe CDATA #IMPLIED
disponívelComoAtalho (true | false)
category CDATA #IMPLIED
modelo CDATA #IMPLIED>
assistente que pode ser usado para criar nova extensão a partir do editor de manifestos de plug-in
- id - nome único que será usado para identificar este assistente.
- nome - nome traduzível que será usado na representação UI deste assistente.
- ícone - caminho relativo de um ícone que será usado para representar visualmente o assistente.
- classe - nome totalmente qualificado de uma classe que implementa a interface org.eclipse.pde.ui.IExtensionWizard. Este atributo é mutuamente exclusivo com o atributo
modelo
.
- disponívelComoAtalho - Se for true, este assistente aparecerá no menu de atalho, na barra de menus e na barra de ferramentas.
- categoria - ID opcional que torna este assistente membro da categoria anteriormente definida. Se a categoria for hierárquica, deve ser especificado o caminho completo para a categoria ascendente, com '/' enquanto delimitador.
- modelo - identificador de um modelo declarado noutro lugar com o ponto de extensão
org.eclipse.pde.ui.templates
. SE definido, o modelo com o ID especificado será localizado e o assistente de extensões será criado com o modelo. Este atributo é mutuamente exclusivo com o atributo classe
.
<!ELEMENT assistenteEditores (descrição?)>
<!ATTLIST assistenteEditores
id CDATA #REQUIRED
name CDATA #REQUIRED
icon CDATA #IMPLIED
class CDATA #REQUIRED
point CDATA #REQUIRED>
assistente que pode ser usado para editar uma extensão existente a partir do editor de manifestos de plug-in
- id - nome único que será usado para identificar este assistente.
- nome - nome traduzível que será usado na representação UI deste assistente.
- ícone - caminho relativo de um ícone que será usado para representar visualmente o assistente.
- classe - nome totalmente qualificado de uma classe que implementa a interface org.eclipse.pde.ui.IExtensionEditorWizard.
- ponto - identificador totalmente qualificado do ponto de extensão que este assistente for capaz de editar
<!ELEMENT category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory CDATA #IMPLIED>
- id - nome único que será usado para referenciar esta categoria.
- nome - nome traduzível que será usado na apresentação UI desta categoria.
- categoriaAscendente - atributo opcional que pode ser usado para criar uma hierarquia de categorias
<!ELEMENT description (#PCDATA)>
Breve descrição deste assistente.
Exemplos:
De seguida é apresentado um exemplo da extensão:
<extension
point=
"org.eclipse.pde.ui.newExtension"
>
<category
name=
"Extensões Personalizadas"
id=
"custom"
>
</category>
<wizard
disponívelComoAtalho
"true"
name=
"Extensão de Editor Java Simples"
icon=
"icons/java_edit.gif"
category=
"genérica"
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ção de manifestos.
</description>
</wizard>
</extension>
Informação de API:
Este ponto de extensão necessita de uma classe que implemente a interface org.eclipse.pde.ui.IExtensionWizard.
Implementação Facultada:
O PDE faculta um assistente genérico que cria pontos de extensão baseados nas informações do esquema de pontos de extensão. Além disso, todos os modelos registados com o ponto de extensão org.eclipse.pde.ui.templates
na UI no PDE também são ligados como assistentes de extensões individuais.
Copyright (c) 2004 IBM Corporation e outros.
Todos os direitos reservados. Este programa e os materiais que o acompanham estão disponíveis sob os termos da Eclipse Public License v1.0 que acompanha esta distribuição e está disponível em http://www.eclipse.org/legal/epl-v10.html.