Přenos předvolby

org.eclipse.ui.preferenceTransfer

3.1

Modul Workbench poskytuje podporu pro udržování předvoleb. Účelem tohoto bodu rozšíření je umožnit modulům plug-in přidávat specifickou podporu pro ukládání a načítání konkrétních skupin předvoleb. Toto se zpravidla používá pro operace jako je import a export.

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

Volitelný dílčí prvek, jehož tělo by mělo představovat krátký popis funkčnosti generátoru přenosu.



<!ELEMENT mapping (entry*)>

<!ATTLIST mapping

scope CDATA #REQUIRED>

Dílčí prvek představující org.eclipse.core.runtime.preferences.IPreferenceFilter. Určuje jedno nebo více mapování z rozsahu org.eclipse.core.runtime.preferences.IScope na nula a více uzlů, kde pro každý uzel je zadáno nula a více klíčů. Pravidla pro chování filtru při exportu a importu najdete ve specifikacích v rámci org.eclipse.core.runtime.preferences.IPreferenceFilter.



<!ELEMENT entry (key*)>

<!ATTLIST entry

node CDATA #IMPLIED>

Dílčí prvek určuje uzly a klíče, které se mají přenést pro daný rozsah.



<!ELEMENT key EMPTY>

<!ATTLIST key

name CDATA #REQUIRED>


Příklad exportu všech přenosů, exportuje všechny uzly pro zadané rozsahy.

   

<extension point=

"org.eclipse.ui.preferenceTransfer"

>

<transfer icon=

"XYZ.gif"

name=

"Test exportu všech přenosů"

id=

"org.eclipse.ui.tests.all"

>

<mapping scope=

"instance"

>

</mapping>

<mapping scope=

"configuration"

>

</mapping>

<mapping scope=

"project"

>

</mapping>

<description>

Export všech přenosů, exportuje všechny uzly pro zadané rozsahy

</description>

</transfer>

</extension>

Velmi jednoduchý přenos poskytuje pouze požadované informace a nic jiného.

   

<extension point=

"org.eclipse.ui.preferenceTransfer"

>

<transfer name=

"Test holého přenosu"

id=

"org.eclipse.ui.tests.all"

>

<mapping scope=

"instance"

>

</mapping>

</transfer>

</extension>

Příklad, který exportuje řadu kombinací klíčů a uzlů

   

<extension point=

"org.eclipse.ui.preferenceTransfer"

>

<transfer icon=

"XYZ.gif"

name=

"Export řady předvoleb"

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>

Export řady kombinací klíčů a uzlů

</description>

</transfer>

</extension>