| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
| <HEAD><meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> |
| </HEAD> |
| <HTML> |
| <BODY> |
| <H1><CENTER>Action Set Part Associations</CENTER></H1> |
| <b><i>Identifier: </i></b>org.eclipse.ui.actionSetPartAssociations<p> |
| <b><i>Description: </i></b>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.<p><b><i>Configuration Markup:</i></b><p> |
| <p><samp> <!ELEMENT extension (actionSetPartAssociation*)></samp> |
| <br><br><samp> <!ATTLIST extension</samp> |
| <br><samp> point CDATA #REQUIRED</samp> |
| <br><samp> id CDATA #IMPLIED</samp> |
| <br><samp> name CDATA #IMPLIED</samp> |
| <br><samp> ></samp> |
| <ul> |
| <li><b>point</b> - a fully qualified identifier of the target extension point</li><li><b>id</b> - an optional identifier of the extension instance</li><li><b>name</b> - an optional name of the extension instance</li></ul> |
| <p><samp> <!ELEMENT actionSetPartAssociation (part*)></samp> |
| <br><br><samp> <!ATTLIST actionSetPartAssociation</samp> |
| <br><samp> targetID CDATA #REQUIRED</samp> |
| <br><samp> ></samp> |
| <ul> |
| <li><b>targetID</b> - the unique identifier of the action set (as specified in the |
| registry) which is to be associated with particular workbench |
| views and/or editors.</li></ul> |
| <p><samp> <!ELEMENT part EMPTY></samp> |
| <br><br><samp> <!ATTLIST part</samp> |
| <br><samp> id CDATA #REQUIRED</samp> |
| <br><samp> ></samp> |
| <ul> |
| <li><b>id</b> - the unique identifier of the part (view or editor) to be associated with the action set.</li></ul> |
| <b><i>Examples: </i></b>The following is an example of an action set part association (note the subelement and the way attributes are used): |
| |
| <p> |
| <pre> |
| <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> |
| </pre> |
| </p> |
| |
| In the example above, a view or editor are associated with the refactoring action set.<p> |
| <b><i>API Information: </i></b>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.<p> |
| <p> |
| 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<p> |
| </BODY> |
| </HTML> |