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
   >

   <!ELEMENT acceleratorScope EMPTY>

   <!ATTLIST acceleratorScope
     id          CDATA #REQUIRED
     name        CDATA #REQUIRED
     description CDATA #REQUIRED
     parentScope CDATA #IMPLIED
   >

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