Eclipse Plug-in Developer Guide
Previous Page	Home	Next Page

Platform Plug-in Developer Guide Reference Extension Points Reference

Accelerator Sets

This extension point is deprecated

Identifier:

org.eclipse.ui.acceleratorSets

Since:

2.0

Description:

WARNING: This extension point is DEPRECATED.
Do not use this extension point, it will be removed in future versions of this product. Instead, use the extension point org.eclipse.ui.commands

This extension point is used to register accelerator set extensions. Accelerator sets are just what the name implies, sets of accelerators. An accelerator is an association between one or more sequences of accelerator keys and a workbench action. An accelerator key sequence may be of length one or greater.

An accelerator set is registered with an accelerator configuration (see the Accelerator Configuration extension point) and is applicable for an accelerator scope (see the Accelerator Scope extension point).

Configuration Markup:

<!ELEMENT extension ( acceleratorSet*)>

<!ATTLIST extension

point CDATA #REQUIRED

id CDATA #IMPLIED

name CDATA #IMPLIED

point - a fully qualified identifier of the target extension point
id - an optional identifier of the extension instance
name - an optional name of the extension instance

The acceleratorSet element is deprecated

<!ELEMENT acceleratorSet ( accelerator+)>

<!ATTLIST acceleratorSet

configurationId CDATA #REQUIRED

scopeId CDATA #REQUIRED

@deprecated Please use the "org.eclipse.ui.bindings" extension point instead. Use the key element.

configurationId - a unique name that identifies the accelerator configuration to which this accelerator set is registered.
scopeId - a unique name that identifies the accelerator scope for which this accelerator set is applicable. @deprecated When migrating to the new bindings extension point, it is recommended that you change any occurrences of "org.eclipse.ui.globalScope" to "org.eclipse.ui.contexts.window".

The accelerator element is deprecated

<!ELEMENT accelerator EMPTY>

<!ATTLIST accelerator

id CDATA #IMPLIED

key CDATA #REQUIRED

locale CDATA #IMPLIED

platform CDATA #IMPLIED

@deprecated Please use the "org.eclipse.ui.bindings" extension point instead. Use the key element.

id - the unique identifier of the action definition of the action associated with this accelerator. If the id is not specified this accelerator deletes any mappings with the same key. This is used to delete a key binding for a specific Locale.
key - an attribute representing the sequence(s) of accelerator keys used to perform the action associated with this accelerator. Sequences are separated by '||', and individual keys in a sequence are separated by a space. A key may be modified by the CTRL, ALT, or SHIFT keys. Depending on keyboard layout, some keys ('?' for example) may need the SHIFT to be accessed but the accelerator should be specified without the SHIFT so it will be independent of keyboard layout. E.g. if CTRL+? is specified as an accelerator, the user may have to press CTRL+SHIFT+? depending on the keyboard layout.
locale - an optional attribute which specifies a locale for which the accelerator is applicable. If this attribute is not specified, the accelerator is applicable for all locales.
platform - an optional attribute which specifies a platform on which the accelerator is applicable. If this attribute is not specified, the accelerator is applicable on all platforms.

Examples:

Following is an example of an accelerator set extension:


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

Supplied Implementation:

The workbench provides accelerator sets for the Default and Emacs accelerator configurations.

Copyright (c) 2002, 2007 IBM Corporation and others.
All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at https://www.eclipse.org/legal/epl-v10.html