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 de Configuração:
<!ELEMENT extension (factory*)>
<!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 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 sobre 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ção Fornecida:
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 que o acompanham são disponibilizados
sob os termos da Eclipse Public License v1.0 que acompanha esta
distribuição e estão disponíveis no endereço http://www.eclipse.org/legal/epl-v10.html