Übertragung von Benutzervorgaben

org.eclipse.ui.preferenceTransfer

3.1

Die Workbench stellt Unterstützung für die Pflege von Benutzervorgaben zur Verfügung. Zweck dieses Erweiterungspunkts ist es, Plug-ins das Hinzufügen von spezifischer Unterstützung für das Speichern und Lagen von bestimmten Gruppen von Benutzervorgaben zu ermöglichen. Typischerweise wird dies bei Operation wie Import und Export verwendet.

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

Dies ist ein optionales Unterelement, dessen Hauptteil eine kurze Beschreibung für die Funktionalität der Übertragungssteuerkomponente darstellen sollte.



<!ELEMENT mapping (entry*)>

<!ATTLIST mapping

scope CDATA #REQUIRED>

Ein Unterelement, das einen org.eclipse.core.runtime.preferences.IPreferenceFilter darstellt. Es spezifiziert 1 oder mehr ZUordnungen aus einem Bereich org.eclipse.core.runtime.preferences.IScope zu 0 oder mehr Knoten, wobei 0 oder mehr Schlüssel pro Knoten angegeben sind. Die Regeln für das Export- und Importverhalten für einen Filter finden Sie in den Spezifikationen in org.eclipse.core.runtime.preferences.IPreferenceFilter.



<!ELEMENT entry (key*)>

<!ATTLIST entry

node CDATA #IMPLIED>

Ein Unterelement, das die Knoten und Schlüssel angibt, die für einen gegebenen Bereich zu übertragen sind.



<!ELEMENT key EMPTY>

<!ATTLIST key

name CDATA #REQUIRED>


Das Beispiel für 'Alles exportieren' exportiert alle Knoten für angegebene Bereiche.

   

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

Übertragung 'Alles exportieren' exportiert alle Knoten für angegebene Bereiche.

</description>

</transfer>

</extension>

Die sehr einfache Übertragung stellt nur die erforderlichen Informationen und nicht mehr zur Verfügung.

   

<extension point=

"org.eclipse.ui.preferenceTransfer"

>

<transfer name=

"Bare Bones Transfer Test"

id=

"org.eclipse.ui.tests.all"

>

<mapping scope=

"instance"

>

</mapping>

</transfer>

</extension>

Beispiel, das viele Kombinationen von Schlüsseln und Knoten exportiert.

   

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

Exportiert viele Kombinationen von Schlüsseln und Knoten.

</description>

</transfer>

</extension>