Direktaufrufsets

Kennung: org.eclipse.ui.acceleratorSets

Beschreibung: 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 Verbindung zwischen einer oder mehreren Sequenzen von Direktaufruftasten und einer Aktion in der Workbench. Eine Tastenfolge für einen Direktaufruf kann Länge 1 oder mehr aufweisen.

Ein Direktaufrufset wird bei einer Direktaufrufkonfiguration registriert (siehe Direktaufrufkonfiguration-Erweiterungspunkt) und ist auf einen Direktaufrufbereich anwendbar (siehe Direktaufrufbereich-Erweiterungspunkt).

Seit: Release 2.0

Konfigurationsformatierung:

   <!ELEMENT acceleratorSet (accelerator)+>
   <!ATTLIST acceleratorSet
      configurationId     CDATA #REQUIRED
      scopeId             CDATA #REQUIRED
   >

   <!ELEMENT accelerator EMPTY>
   <!ATTLIST accelerator
      id                  CDATA #REQUIRED
      key                 CDATA #REQUIRED
      locale              CDATA #OPTIONAL
      platform            CDATA #OPTIONAL
   >

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

Wenn die Locale und/oder Plattform angegeben ist, wird jener Direktaufruf verwendet, der der aktuellen Locale und Plattform eher entspricht. Die aktuelle Locale wird über API Locale.getDefault() und die Plattform über API SWT.getPlatform() feestgelegt. Wenn Plattform und/oder Locale angegeben sind und nicht der aktuellen Locale und/oder Plattform entsprechen, wird der Direktaufruf verworfen. Wenn Direktaufruf A nur die Locale un B nur die Plattform definiert, wird B verwendet. Wenn Direktaufruf A "ja" als seine Locale und B "ja_JP" definiert, wird B verwendet, falls die aktuelle Locale "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.

Beispiele:

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"
             j key="STRG+R STRG+A"
          </accelerator>
          <accelerator
              id="org.eclipse.ui.ExampleActionB"
              key="STRG+R STRG+B"
          </accelerator>
          <accelerator
              id="org.eclipse.ui.ExampleActionC"
              key="STRG+R STRG+C || STRG+UMSCHALT+ENTF"
          </accelerator>
      </acceleratorSet>
   </extension>

API-Informationen: Keine.

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

Copyright IBM Corporation und Andere 2000, 2002.