Criações de Elementos
Identificador:
org.eclipse.ui.elementFactories
Descrição:
Esse ponto de extensão é utilizado para incluir depósitos de informações do provedor do elemento no workbench. Uma criação de elemento é utilizada para recriar objetos IAdaptable que são preservados durante o encerramento do workbench.
Como exemplo, a criação de elemento é utilizada para que a entrada do editor seja preservada. A entrada de um editor deve implementar org.eclipse.ui.EditorInput.
O ciclo de vida de IEditorInput em um editor possui diversas fases.
-
A entrada inicial de um editor é transmitida durante sua criação.
-
Durante o encerramento, o estado do workbench é capturado.
Nesse processo, o workbench criará um memento para cada editor aberto e para suas entradas. A entrada é salva como um memento de duas partes que contém um ID de criação e todos os dados primitivos necessários para recriar o elemento durante a inicialização. Para obter informações adicionais, consulte a documentação em org.eclipse.ui.IPersistableElement.
-
Durante a inicialização, o estado do workbench é lido e os editores da sessão anterior são recriados.
Nesse processo, o workbench recriará o elemento de entrada para cada editor aberto. Para que isso ocorra, ele mapeará o ID de criação original para o elemento de entrada de uma classe de criação concreta definida no registro.
Se já existir um mapeamento e a classe de criação for válida, será criada uma instância da classe de criação. Em seguida, o workbench solicitará a recriação do elemento original a partir de dados primitivos restantes no memento. O IAdaptable resultante será difundido a um IEditorInput e transmitido para o novo editor.
Marcação da Configuração:
<!ELEMENT extension (factory*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - um identificador completamente qualificado do ponto de extensão do destino
- id - um identificador opcional da instância da extensão
- name - um nome opcional da instância da extensão
<!ELEMENT factory EMPTY>
<!ATTLIST factory
id CDATA #REQUIRED
class CDATA #REQUIRED>
- id - nome único que será utilizado para identificar essa criação.
- class - nome completo de uma classe que implementa org.eclipse.ui.IElementFactory
Exemplos:
A seguir um exemplo de uma extensão do fator elemento:
<extension
point =
"org.eclipse.ui.elementFactories"
>
<factory
id =
"com.xyz.ElementFactory"
class=
"com.xyz.ElementFactory"
>
</factory>
</extension>
Informações da API:
O valor do atributo class deve ser um nome completo de uma classe que implemente org.eclipse.ui.IElementFactory. Uma ocorrência dessa classe deve criar um objeto IAdaptable a partir da anotação do workbench.
Implementações Fornecidas:
O workbench fornece um depósito de informações do provedor IResource.
Criações adicionais devem ser incluídas para recriar outros tipos de IAdaptable, geralmente encontrados em outros modelos de objetos, como, por exemplo, nos Modelos Java.
Direitos Autorais (c) 2002, 2004 IBM Corporation e outros.
Todos os direitos reservados. Este programa e os materiais fornecidos com ele são
disponibilizados sob os termos da Licença Pública do Eclipse v1.0 que acompanha
esta distribuição e está disponível em
http://www.eclipse.org/legal/epl-v10.html