Action Set Part Associations

Identifier:
org.eclipse.ui.actionSetPartAssociations

Description:
This extension point is used to define an action set which should be added to a perspective when a part (view or editor) is opened in the perspective. In the case of an editor, the action set will remain visible while the editor is the current editor. In the case of a view, the action set will be visible when the view is the active part.

Configuration Markup:

<!ELEMENT extension (actionSetPartAssociation*)>

<!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 actionSetPartAssociation (part*)>

<!ATTLIST actionSetPartAssociation

targetID CDATA #REQUIRED>

targetID - the unique identifier of the action set (as specified in the registry) which is to be associated with particular workbench views and/or editors.

<!ELEMENT part EMPTY>

<!ATTLIST part

id CDATA #REQUIRED>

id - the unique identifier of the part (view or editor) to be associated with the action set.

Examples:
The following is an example of an action set part association (note the subelement and the way attributes are used):
 <extension point=
"org.eclipse.ui.actionSetPartAssociations"
>
  <actionSetPartAssociation targetID=
"org.eclipse.jdt.ui.refactoring.actionSet"
>
   <part id=
"org.eclipse.jdt.ui.PackageExplorer"
/>
   <part id=
"org.eclipse.jdt.ui.CompilationUnitError"
/>
  </actionSetPartAssociation>
 </extension>
In the example above, a view or editor are associated with the refactoring action set.

API Information:
The user may override these associations using the customize perspective dialog. Regardless of these associations, action sets which the user turns off will never appear and action sets which the user turns on will always be visible.

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