Transfert de préférences

org.eclipse.ui.preferenceTransfer

3.1

Le plan de travail permet de prendre en charge la gestion des préférences. Le but de ce point d'extension est de permettre aux plug-ins d'accroître la prise en charge spécifique pour l'enregistrement et le chargement de groupes spécifiques de préférences. Généralement, celui-ci est utilisé pour des opérations telles que l'importation ou l'exportation.

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

Sous-élément facultatif dont le corps doit comporter une brève description de la fonctionnalité du moteur de transfert.



<!ELEMENT mapping (entry*)>

<!ATTLIST mapping

scope CDATA #REQUIRED>

Sous-élément représentant un org.eclipse.core.runtime.preferences.IPreferenceFilter. Il indique un ou plusieurs mappages à partir d'une portée org.eclipse.core.runtime.preferences.IScope vers 0 ou plusieurs noeuds où 0 ou plusieurs clés sont indiquées par noeud. Les règles relatives au comportement d'exportation et d'importation peuvent être consultées dans les spécifications se trouvant dans org.eclipse.core.runtime.preferences.IPreferenceFilter.



<!ELEMENT entry (key*)>

<!ATTLIST entry

node CDATA #IMPLIED>

Sous-élément indiquant les noeuds et clés devant être transférés pour une portée donnée



<!ELEMENT key EMPTY>

<!ATTLIST key

name  CDATA #REQUIRED>


Exemple exportant tous les transferts, tous les noeuds pour des portées spécifiées.

   

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

Exporte tous les transferts, tous les noeuds pour des portées spécifiées

</description>

</transfer>

</extension>

Transfert très simple ne fournissant que les informations requises, et rien d'autre.

   

<extension point=

"org.eclipse.ui.preferenceTransfer"

>

<transfer name=

"Bare Bones Transfer Test"

id=

"org.eclipse.ui.tests.all"

>

<mapping scope=

"instance"

>

</mapping>

</transfer>

</extension>

Exemple exportant de nombreuses combinaisons de clés et de noeuds

   

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

Exporte de nombreuses combinaisons de clés et de noeuds

</description>

</transfer>

</extension>