Accelerator Scopes

Identifier: org.eclipse.ui.acceleratorScopes

Description: This extension point is used to register accelerator scope extensions. Accelerator scopes are scopes for which accelerator sets may be applicable. For example, if an accelerator set is applicable for the scope entitled "Text Editor Scope", the accelerators of that accelerator set will only operate if the "Text Editor Scope" or one of its children is active (in other words, if the active part is a participating text editor).

An accelerator set declares what scope it is applicable for by listing the scope's id as the value of its "scopeId" attribute (see the Accelerator Sets extension point). Many accelerator sets can be applicable for the same accelerator scope.

Since: Release 2.0

Configuration Markup:

   <!ELEMENT acceleratorScope EMPTY>
   <!ATTLIST acceleratorScope
      id             CDATA #REQUIRED
      name           CDATA #REQUIRED
      description    CDATA #REQUIRED
      parentScope    CDATA #OPTIONAL
   >

id - a unique name that can be used to identify this accelerator scope.
name - a translatable name of the accelerator scope.
description - a short description of the accelerator scope.
parentScope - an optional attribute which represents a scope which is active whenever this scope is active. For most scopes, org.eclipse.ui.globalScope will be the parent scope

Examples:

Following is an example of an accelerator scope extension:

   <extension point="org.eclipse.ui.acceleratorScopes">
      <acceleratorScope
        id="org.eclipse.ui.globalScope"
        name="Global"
        description="Action accelerator key applicable to all views and editors unless explicitly overridden.">
      </acceleratorScope>
      <acceleratorScope
        id="org.eclipse.ui.javaEditorScope"
        name="Java Editor"
        description="Action accelerator key applicable only when java editor active."
        parentScope="org.eclipse.ui.globalScope">
      </acceleratorScope>
   </extension>

API Information: The method public IKeyBindingService getKeyBindingService() was added to IEditorSite.

Supplied Implementation: The workbench provides the Global accelerator scope and the Text Editor accelerator scope.