Direktaufrufsets

org.eclipse.ui.acceleratorSets

Freigabe 2.0

ACHTUNG: Dieser Erweiterungspunkt ist VERALTET.
Verwenden Sie diesen Erweiterungspunkt nicht, da er in künftigen Versionen dieses Produkts entfernt wird. Verwenden Sie stattdessen den Erweiterungspunkt org.eclipse.ui.commands.

An diesem Erweiterungspunkt können Erweiterungen für Direktaufrufsets registriert werden. Wie der Name schon sagt sind Direktaufrufsets Gruppen von Direktaufrufen. Ein Direktaufruf ist eine Zuordnung von einer oder mehreren Tastenfolgen für einen Direktaufruf und einer Workbenchaktion. Eine Tastenfolge für einen Direktaufruf kann Länge 1 oder mehr aufweisen.

Ein Direktaufrufset wird mit einer Direktaufrufkonfiguration registriert (siehe Erweiterungspunkt für Direktaufrufkonfigurationen) und gilt für einen Direktaufrufbereich (siehe Erweiterungspunkt für Direktaufrufbereiche).

<!ELEMENT extension (acceleratorSet*)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT acceleratorSet (accelerator+)>

<!ATTLIST acceleratorSet

configurationId CDATA #REQUIRED

scopeId         CDATA #REQUIRED>

@veraltet Bitte benutzen Sie stattdessen den Erweiterungspunkt 'org.eclipse.ui.bindings'. Verwenden Sie das Element Schlüssel.



<!ELEMENT accelerator EMPTY>

<!ATTLIST accelerator

id       CDATA #IMPLIED

key      CDATA #REQUIRED

locale   CDATA #IMPLIED

platform CDATA #IMPLIED>

@veraltet Bitte verwenden Sie statt dessen den Erweiterungspunkt "org.eclipse.ui.bindings". Verwenden Sie das Element Schlüssel.



Das folgende Beispiel stellt eine Direktaufrufset-Erweiterung dar:

   

<extension point=

"org.eclipse.ui.acceleratorSets"

>

<acceleratorSet configurationId=

"org.eclipse.ui.exampleAcceleratorConfiguration"

scopeId=

"org.eclipse.ui.globalScope"

>

<accelerator id=

"org.eclipse.ui.ExampleActionA"

key=

"CTRL+R CTRL+A"

>

</accelerator>

<accelerator id=

"org.eclipse.ui.ExampleActionB"

key=

"CTRL+R CTRL+B"

>

</accelerator>

<accelerator id=

"org.eclipse.ui.ExampleActionC"

key=

"CTRL+R CTRL+C || CTRL+SHIFT+DELETE"

>

</accelerator>

</acceleratorSet>

</extension>

Für dieselbe Aktion können mehrere Direktaufrufe im Direktaufrufset festgelegt werden, doch es wird nur ein Direktaufruf verwendet.

Wenn die Ländereinstellung und/oder Plattform angegeben ist, wird jener Direktaufruf verwendet, der der aktuellen Ländereinstellung und Plattform eher entspricht. Die aktuelle Ländereinstellung wird über API Locale.getDefault() und die Plattform über API SWT.getPlatform() festgelegt. Wenn Plattform und/oder Ländereinstellung angegeben sind und nicht der aktuellen Ländereinstellung und/oder Plattform entsprechen, wird der Direktaufruf verworfen. Wenn Direktaufruf A nur die Ländereinstellung und B nur die Plattform definiert, wird B verwendet. Wenn Direktaufruf A "ja" als seine Ländereinstellung und B "ja_JP" definiert, wird B verwendet, falls die aktuelle Ländereinstellung "ja_JP" ist.

Wenn zwei Direktaufrufe in Direktaufrufsets in unterschiedlichen Plug-ins definiert werden, hängt die Wahl des Direktaufrufs von den Plug-ins ab. Wenn Plug-in A von B abhängt, werden die in B definierten Direktaufrufe verwendet. Wenn A und B unabhängig voneinander sind, werden sie alphabetisch nach Plug-in-ID sortiert.

Wenn zwei Direktaufrufe in unterschiedlichen Bereichen definiert sind, wird der im aktuellen Bereich definierte Direktaufruf verwendet. Wenn ein Direktaufruf nicht im aktuellen Bereich oder einem übergeordneten Bereich definiert ist, wird er verworfen. Wenn ein Direktaufruf in einem übergeordneten und einem untergeordneten Bereich definiert ist, wird jener des untergeordneten Bereichs verwendet.

Die Workbench liefert Direktaufrufsets für die Standard- und Emacs-Direktaufrufkonfigurationen.