Accelerator Scopes

Identifier:

org.eclipse.ui.acceleratorScopes

Since:

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

Configuration Markup:

<!ELEMENT extension (acceleratorScope*)>

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

<!ELEMENT acceleratorScope EMPTY>

<!ATTLIST acceleratorScope

id          CDATA #REQUIRED

name        CDATA #REQUIRED

description CDATA #REQUIRED

parentScope CDATA #IMPLIED>

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

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