Direktaufrufsets

Kennung: org.eclipse.ui.acceleratorSets

Seit: Release 2.0

Beschreibung:

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

Konfigurationsbefehle:

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

   <!ELEMENT accelerator EMPTY>

   <!ATTLIST accelerator
     id       CDATA #IMPLIED
     key      CDATA #REQUIRED
     locale   CDATA #IMPLIED
     platform CDATA #IMPLIED
   >

Beispiele: Das folgende Beispiel zeigt eine Erweiterung für ein Direktaufrufset:

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

API-Informationen: Für dieselbe Aktion können im Direktaufrufset mehrere Direktaufrufe angegeben werden. Es wird jedoch 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.

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

Copyright (c) 2002 IBM Corporation und Andere. Alle Rechte vorbehalten. Dieses Programm und sein Begleitmaterial werden unter den Bedingungen der "Common Public License v1.0" bereitgestellt, die diese Verteilung begleitet und unter "http://www.eclipse.org/legal/cpl-v10.html" abgerufen werden kann.