Przekazywanie preferencji

org.eclipse.ui.preferenceTransfer

3.1

Środowisko robocze udostępnia obsługę preferencji. Przeznaczeniem tego punktu rozszerzenia jest umożliwienie modułom dodatkowym dodawania określonej obsługi zapisywania i ładowania konkretnych grup preferencji. Zazwyczaj funkcje te stosuje się przy takich operacjach, jak importowanie lub eksportowanie.

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

Opcjonalny podelement, którego treść powinien stanowić krótki opis funkcji mechanizmu przekazywania.



<!ELEMENT mapping (entry*)>

<!ATTLIST mapping

scope CDATA #REQUIRED>

Podelement reprezentujący interfejs org.eclipse.core.runtime.preferences.IPreferenceFilter. Określa jedno lub większą liczbę odwzorowań z zasięgu interfejsu org.eclipse.core.runtime.preferences.IScope na 0 lub większą liczbę węzłów, gdzie określonych jest 0 lub więcej kluczy na węzeł. Reguły zachowania eksportu i importu dla filtru można znaleźć w specyfikacjach interfejsu org.eclipse.core.runtime.preferences.IPreferenceFilter.



<!ELEMENT entry (key*)>

<!ATTLIST entry

node CDATA #IMPLIED>

Podelement określający węzły i klucze, które mają zostać przekazane do podanego zasięgu.



<!ELEMENT key EMPTY>

<!ATTLIST key

name CDATA #REQUIRED>


Przykład eksportu wszystkich przekazań, gdzie eksportowane są wszystkie węzły dla określonych zasięgów.

   

<extension point=

"org.eclipse.ui.preferenceTransfer"

>

<transfer icon=

"XYZ.gif"

name=

"Test eksportu wszystkich przekazań"

id=

"org.eclipse.ui.tests.all"

>

<mapping scope=

"instance"

>

</mapping>

<mapping scope=

"configuration"

>

</mapping>

<mapping scope=

"project"

>

</mapping>

<description>

Eksport wszystkich przekazań; eksportowane są wszystkie węzły dla określonych zasięgów

</description>

</transfer>

</extension>

Bardzo proste przekazanie udostępnia tylko wymagane informacje i nic ponadto.

   

<extension point=

"org.eclipse.ui.preferenceTransfer"

>

<transfer name=

"Test przekazania Bare Bones"

id=

"org.eclipse.ui.tests.all"

>

<mapping scope=

"instance"

>

</mapping>

</transfer>

</extension>

Przykład eksportu wielu kombinacji kluczy i węzłów.

   

<extension point=

"org.eclipse.ui.preferenceTransfer"

>

<transfer icon=

"XYZ.gif"

name=

"Eksport wielu preferencji"

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>

Eksport wielu kombinacji kluczy i węzłów

</description>

</transfer>

</extension>