Transferência de Preferências

org.eclipse.ui.preferenceTransfer

3.1

A área de trabalho fornece o suporte para manter as preferências. O objectivo deste ponto de extensão é permitir aos conectores adicionar suporte específico para guardar e carregar grupos específicos de preferências. Normalmente, é utilizado para operações como Importar e Exportar.

<!ELEMENT extension (transfer*)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT transfer (mapping+ , description?)>

<!ATTLIST transfer

id   CDATA #REQUIRED

name CDATA #REQUIRED

icon CDATA #IMPLIED>


<!ELEMENT description (#PCDATA)>

um subelemento opcional, cujo corpo deverá representar uma descrição breve da funcionalidade de motor de transferências.



<!ELEMENT mapping (entry*)>

<!ATTLIST mapping

scope CDATA #REQUIRED>

um subelemento que representa org.eclipse.core.runtime.preferences.IPreferenceFilter. Especifica uma ou mais correlações a partir de um âmbito org.eclipse.core.runtime.preferences.IScope para 0 ou mais nós, onde são especificadas 0 ou mais chaves por nó. As regras para o comportamento de exportação e importação para um filtro podem encontrar-se nas especificações em org.eclipse.core.runtime.preferences.IPreferenceFilter.



<!ELEMENT entry (key*)>

<!ATTLIST entry

node CDATA #IMPLIED>

um subelemento que especifica os nós e as chaves que serão transferidos para um determinado âmbito



<!ELEMENT key EMPTY>

<!ATTLIST key

name CDATA #REQUIRED>


Exemplo que exporta todas as transferências, exporta todos os nós para âmbitos especificados.

   

<extension point=

"org.eclipse.ui.preferenceTransfer"

>

<transfer icon=

"XYZ.gif"

name=

"Export All Transfer Test"

id=

"org.eclipse.ui.tests.all"

>

<mapping scope=

"instance"

>

</mapping>

<mapping scope=

"configuration"

>

</mapping>

<mapping scope=

"project"

>

</mapping>

<description>

Exporta todas as transferências, exporta todos os nós para âmbitos especificados

</description>

</transfer>

</extension>

O Very Simple Transfer só fornece as informações necessárias.

   

<extension point=

"org.eclipse.ui.preferenceTransfer"

>

<transfer name=

"Bare Bones Transfer Test"

id=

"org.eclipse.ui.tests.all"

>

<mapping scope=

"instance"

>

</mapping>

</transfer>

</extension>

Exemplo que exporta muitas combinações de chaves e nós

   

<extension point=

"org.eclipse.ui.preferenceTransfer"

>

<transfer icon=

"XYZ.gif"

name=

"Export many preferences"

id=

"org.eclipse.ui.tests.all"

>

<mapping scope=

"instance"

>

<entry node=

"org.eclipse.ui"

>

<key name=

"showIntro,DOCK_PERSPECTIVE_BAR"

/>

</entry>

<entry node=

"org.eclipse.ui.workbench"

>

<key name=

"bogus,RUN_IN_BACKGROUND"

/>

</entry>

<entry node=

"org.eclipse.ui.ide"

/>

<entry node=

"org.eclipse.core.resources"

/>

</mapping>

<mapping scope=

"configuration"

>

</mapping>

<description>

Exporta muitas combinações de chaves e nós

</description>

</transfer>

</extension>