Trasferimento preferenze

org.eclipse.ui.preferenceTransfer

3.1

Il workbench fornisce il supporto per la gestione delle preferenze. Lo scopo di questo punto di estensione è consentire ai plugin di aggiungere il supporto specifico per il salvataggio e il caricamento di determinati gruppi di preferenze. Generalmente viene utilizzato per operazioni come importazione ed esportazione.

<!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)>

Un elemento secondario facoltativo il cui corpo rappresenta una breve descrizione delle funzionalità del motore di trasferimento.



<!ELEMENT mapping (entry*)>

<!ATTLIST mapping

scope CDATA #REQUIRED>

Un elemento secondario che rappresenta un org.eclipse.core.runtime.preferences.IPreferenceFilter. Specifica una o più associazioni da un ambito org.eclipse.core.runtime.preferences.IScope a zero o più nodi nei quali sono specificate zero o più chiavi per nodo. Le regole del comportamento di esportazione e importazione si possono trovare nelle specifiche di org.eclipse.core.runtime.preferences.IPreferenceFilter.



<!ELEMENT entry (key*)>

<!ATTLIST entry

node CDATA #IMPLIED>

Un elemento secondario che specifica i nodi e le chiavi da trasferire per un ambito fornito



<!ELEMENT key EMPTY>

<!ATTLIST key

name  CDATA #REQUIRED>


Esempio di esportazione di tutti i trasferimenti, esporta tutti i nodi per gli ambiti specificati.

   

<extension point=

"org.eclipse.ui.preferenceTransfer"

>

<transfer icon=

"XYZ.gif"

name=

"Esporta tutte le verifiche di trasgerimento"

id=

"org.eclipse.ui.tests.all"

>

<mapping scope=

"instance"

>

</mapping>

<mapping scope=

"configuration"

>

</mapping>

<mapping scope=

"project"

>

</mapping>

<descrizione>

Esporta tutti i trasferimenti, esporta tutti i nodi per gli ambiti specificati

</description>

</transfer>

</extension>

Trasferimento semplice, fornisce solo le informazioni obbligatorie.

   

<extension point=

"org.eclipse.ui.preferenceTransfer"

>

<transfer name=

"Verifica trasferimento base"

id=

"org.eclipse.ui.tests.all"

>

<mapping scope=

"instance"

>

</mapping>

</transfer>

</extension>

Esempio di esportazione di molte combinazioni di chiavi e nodi

   

<extension point=

"org.eclipse.ui.preferenceTransfer"

>

<transfer icon=

"XYZ.gif"

name=

"Esporta molte preferenze"

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>

<descrizione>

Esporta molte combinazioni di chiavi e nodi

</description>

</transfer>

</extension>