| <?xml version='1.0' encoding='UTF-8'?> |
| <!-- Schema file written by PDE --> |
| <schema targetNamespace="org.eclipse.ui"> |
| <annotation> |
| <appInfo> |
| <meta.schema plugin="org.eclipse.ui" id="viewActions" name="View Menus,Toolbars and Actions"/> |
| </appInfo> |
| <documentation> |
| This extension point is used to add actions to the pulldown menu and toolbar for views registered by other plug-ins. Each view has a local pulldown menu normally activated |
| by clicking on the top right triangle button. Other plug-ins can contribute submenus and actions to this menu. Plug-ins may also contribute actions to a view toolbar. View owners are first given a chance to populate these areas. Optional additions by other plug-ins are appended. |
| </documentation> |
| </annotation> |
| |
| <include schemaLocation="commonAction.exsd"/> |
| |
| <include schemaLocation="commonExpression.exsd"/> |
| |
| <element name="extension"> |
| <complexType> |
| <sequence> |
| <element ref="viewContribution" minOccurs="1" maxOccurs="unbounded"/> |
| </sequence> |
| <attribute name="point" type="string" use="required"> |
| <annotation> |
| <documentation> |
| a fully qualified identifier of the target extension point |
| </documentation> |
| </annotation> |
| </attribute> |
| <attribute name="id" type="string"> |
| <annotation> |
| <documentation> |
| an optional identifier of the extension instance |
| </documentation> |
| </annotation> |
| </attribute> |
| <attribute name="name" type="string"> |
| <annotation> |
| <documentation> |
| an optional name of the extension instance |
| </documentation> |
| <appInfo> |
| <meta.attribute translatable="true"/> |
| </appInfo> |
| </annotation> |
| </attribute> |
| </complexType> |
| </element> |
| |
| <element name="viewContribution"> |
| <annotation> |
| <documentation> |
| This element is used to define a group of view actions and/or menus. |
| </documentation> |
| </annotation> |
| <complexType> |
| <sequence> |
| <element ref="menu" minOccurs="0" maxOccurs="unbounded"/> |
| <element ref="action" minOccurs="0" maxOccurs="unbounded"/> |
| </sequence> |
| <attribute name="id" type="string" use="required"> |
| <annotation> |
| <documentation> |
| a unique identifier used to reference this contribution. |
| </documentation> |
| </annotation> |
| </attribute> |
| <attribute name="targetID" type="string" use="required"> |
| <annotation> |
| <documentation> |
| a unique identifier of a registered view that is the target of this contribution. |
| </documentation> |
| </annotation> |
| </attribute> |
| </complexType> |
| </element> |
| |
| <element name="action"> |
| <annotation> |
| <appInfo> |
| <meta.element labelAttribute="label" icon="icon"/> |
| </appInfo> |
| <documentation> |
| This element defines an action that the user can invoke in the UI. |
| </documentation> |
| </annotation> |
| <complexType> |
| <choice> |
| <element ref="selection" minOccurs="0" maxOccurs="unbounded"/> |
| <element ref="enablement" minOccurs="0" maxOccurs="1"/> |
| </choice> |
| <attribute name="id" type="string" use="required"> |
| <annotation> |
| <documentation> |
| a unique identifier used as a reference for this action. |
| </documentation> |
| </annotation> |
| </attribute> |
| <attribute name="label" type="string" use="required"> |
| <annotation> |
| <documentation> |
| a translatable name used either as the menu item text or toolbar button label. The name can include mnenomic information. |
| </documentation> |
| <appInfo> |
| <meta.attribute translatable="true"/> |
| </appInfo> |
| </annotation> |
| </attribute> |
| <attribute name="menubarPath" type="string"> |
| <annotation> |
| <documentation> |
| a slash-delimited path ('/') used to specify the location of this action in the pulldown menu. Each token in the path, except the last one, must represent a valid identifier of an existing menu in the hierarchy. The last token represents the named group into which this action will be added. If the path is omitted, this action will not appear in the pulldown menu. |
| </documentation> |
| </annotation> |
| </attribute> |
| <attribute name="toolbarPath" type="string"> |
| <annotation> |
| <documentation> |
| a named group within the local toolbar of the target view. If the group does not exist, it will be created. If omitted, the action will not appear in the local toolbar. |
| </documentation> |
| </annotation> |
| </attribute> |
| <attribute name="icon" type="string"> |
| <annotation> |
| <documentation> |
| a relative path of an icon used to visually represent the action in its context. |
| If omitted and the action appears in the toolbar, the Workbench will use a placeholder icon. The path is relative to the location of the plugin.xml file of the contributing plug-in. The icon will appear in the toolbar but not in the pulldown menu. |
| </documentation> |
| <appInfo> |
| <meta.attribute kind="resource"/> |
| </appInfo> |
| </annotation> |
| </attribute> |
| <attribute name="disabledIcon" type="string"> |
| <annotation> |
| <documentation> |
| a relative path of an icon used to visually represent the action in its context when the action is disabled. If omitted, the normal icon will simply appear greyed out. The path is relative to the location of the plugin.xml file of the contributing plug-in. The disabled icon will appear in the toolbar but not in the pulldown menu. |
| </documentation> |
| <appInfo> |
| <meta.attribute kind="resource"/> |
| </appInfo> |
| </annotation> |
| </attribute> |
| <attribute name="hoverIcon" type="string"> |
| <annotation> |
| <documentation> |
| a relative path of an icon used to visually represent the action in its context when the mouse pointer is over the action. If omitted, the normal icon will be used. The path is relative to the location of the plugin.xml file of the contributing plug-in. |
| </documentation> |
| <appInfo> |
| <meta.attribute kind="resource"/> |
| </appInfo> |
| </annotation> |
| </attribute> |
| <attribute name="tooltip" type="string"> |
| <annotation> |
| <documentation> |
| a translatable text representing the action's tool tip. Only used if the action appears in the toolbar. |
| </documentation> |
| <appInfo> |
| <meta.attribute translatable="true"/> |
| </appInfo> |
| </annotation> |
| </attribute> |
| <attribute name="helpContextId" type="string"> |
| <annotation> |
| <documentation> |
| a unique identifier indicating the help context for this action. On some platforms, if the action appears as a menu item, then pressing the appropriate help key while the menu item is highlighted will display help. Not all platforms support this behaviour. |
| </documentation> |
| </annotation> |
| </attribute> |
| <attribute name="style" use="default" value="push"> |
| <annotation> |
| <documentation> |
| an optional attribute to define the user interface style type for the action. If defined, the attribute value will be one of the following: |
| <table border="0" width="80%"> |
| <tr> |
| <td valign="top" width="25"></td> |
| <td valign="top" nowrap><b>push</b></td> |
| <td valign="top">- as a regular menu item or tool item.</td> |
| </tr> |
| <tr> |
| <td valign="top" width="25"></td> |
| <td valign="top" nowrap><b>radio</b></td> |
| <td valign="top">- as a radio style menu item or tool item. Actions with the radio style within the same menu or toolbar group behave as a radio set. The initial value is specified by the <samp>state</samp> attribute.</td> |
| </tr> |
| <tr> |
| <td valign="top" width="25"></td> |
| <td valign="top" nowrap><b>toggle</b></td> |
| <td valign="top">- as a checked style menu item or as a toggle tool item. The initial value is specified by the <samp>state</samp> attribute.</td> |
| </tr> |
| </table> |
| </documentation> |
| </annotation> |
| <simpleType> |
| <restriction base="string"> |
| <enumeration value="push"> |
| </enumeration> |
| <enumeration value="radio"> |
| </enumeration> |
| <enumeration value="toggle"> |
| </enumeration> |
| </restriction> |
| </simpleType> |
| </attribute> |
| <attribute name="state" type="boolean"> |
| <annotation> |
| <documentation> |
| an optional attribute indicating the initial state (either <samp>true</samp> or <samp>false</samp>), used when the <samp>style</samp> attribute has the value <samp>radio</samp> or <samp>toggle</samp>. |
| </documentation> |
| </annotation> |
| </attribute> |
| <attribute name="class" type="string" use="required"> |
| <annotation> |
| <documentation> |
| name of the fully qualified class that implements <samp>org.eclipse.ui.IViewActionDelegate</samp>. |
| </documentation> |
| <appInfo> |
| <meta.attribute kind="java" basedOn="org.eclipse.ui.IViewActionDelegate"/> |
| </appInfo> |
| </annotation> |
| </attribute> |
| <attribute name="enablesFor" type="string"> |
| <annotation> |
| <documentation> |
| a value indicating the selection count which must be met to enable the action. |
| If this attribute is specified and the condition is met, the action is enabled. |
| If the condition is not met, the action is disabled. |
| If no attribute is specified, the action is enabled for any number of items selected. |
| The following attribute formats are supported: |
| <table border="0" width="80%"> |
| <tr> |
| <td valign="top" width="25"></td> |
| <td valign="top" nowrap><b>!</b></td> |
| <td valign="top">- 0 items selected</td> |
| </tr> |
| <tr> |
| <td valign="top" width="25"></td> |
| <td valign="top" nowrap><b>?</b></td> |
| <td valign="top">- 0 or 1 items selected</td> |
| </tr> |
| <tr> |
| <td valign="top" width="25"></td> |
| <td valign="top" nowrap><b>+</b></td> |
| <td valign="top">- 1 or more items selected</td> |
| </tr> |
| <tr> |
| <td valign="top" width="25"></td> |
| <td valign="top" nowrap><b>multiple, 2+</b></td> |
| <td valign="top">- 2 or more items selected</td> |
| </tr> |
| <tr> |
| <td valign="top" width="25"></td> |
| <td valign="top" nowrap><b>n</b></td> |
| <td valign="top">- a precise number of items selected.a precise number of items selected.&nbsp; |
| For example: enablesFor=&quot; 4&quot; enables the action only when 4 |
| items are selected</td> |
| </tr> |
| <tr> |
| <td valign="top" width="25"></td> |
| <td valign="top" nowrap><b>*</b></td> |
| <td valign="top">- any number of items selected</td> |
| </tr> |
| </table> |
| </documentation> |
| </annotation> |
| </attribute> |
| </complexType> |
| </element> |
| |
| <annotation> |
| <appInfo> |
| <meta.section type="examples"/> |
| </appInfo> |
| <documentation> |
| The following is an example of a view action extension: |
| <p> |
| <pre> |
| <extension point="org.eclipse.ui.viewActions"> |
| <viewContribution |
| id="com.xyz.xyzViewC1" |
| targetID="org.eclipse.ui.views.navigator.ResourceNavigator"> |
| <menu |
| id="com.xyz.xyzMenu" |
| label="XYZ Menu" |
| path="additions"> |
| <separator name="group1"/> |
| </menu> |
| <action |
| id="com.xyz.runXYZ" |
| label="&amp;Run XYZ Tool" |
| menubarPath="com.xyz.xyzMenu/group1" |
| toolbarPath="Normal/additions" |
| style="toggle" |
| state="true" |
| icon="icons/runXYZ.gif" |
| tooltip="Run XYZ Tool" |
| helpContextId="com.xyz.run_action_context" |
| class="com.xyz.actions.RunXYZ"> |
| <selection class="org.eclipse.core.resources.IFile" name="*.java"/> |
| </action> |
| </viewContribution> |
| </extension> |
| </pre> |
| </p> |
| <p> |
| In the example above, the specified action will only enable for a single selection (<samp>enablesFor</samp> attribute). In addition, the object in the selection must be a Java file resource. |
| </p> |
| <p> |
| The following is an other example of a view action extension: |
| </p> |
| <p> |
| <pre> |
| <extension point="org.eclipse.ui.viewActions"> |
| <viewContribution |
| id="com.xyz.xyzViewC1" |
| targetID="org.eclipse.ui.views.navigator.ResourceNavigator"> |
| <menu |
| id="com.xyz.xyzMenu" |
| label="XYZ Menu" |
| path="additions"> |
| <separator name="group1"/> |
| </menu> |
| <action |
| id="com.xyz.runXYZ2" |
| label="&amp;Run XYZ2 Tool" |
| menubarPath="com.xyz.xyzMenu/group1" |
| style="push" |
| icon="icons/runXYZ2.gif" |
| tooltip="Run XYZ2 Tool" |
| helpContextId="com.xyz.run_action_context2" |
| class="com.xyz.actions.RunXYZ2"> |
| <enablement> |
| <and> |
| <objectClass name="org.eclipse.core.resources.IFile"/> |
| <not> |
| <objectState name="extension" value="java"/> |
| </not> |
| </and> |
| </enablement> |
| </action> |
| </viewContribution> |
| </extension> |
| </pre> |
| </p> |
| <p> |
| In the example above, the specified action will appear as a menu item. The action is enabled if the selection contains no Java file resources. |
| </documentation> |
| </annotation> |
| |
| <annotation> |
| <appInfo> |
| <meta.section type="apiInfo"/> |
| </appInfo> |
| <documentation> |
| The value of the <samp>class</samp> attribute must be a fully qualified name of a Java class that implements <samp>org.eclipse.ui.IViewActionDelegate</samp>. This class is loaded as late as possible to avoid loading the entire plug-in before it is really needed. |
| <p> |
| The interface <samp>org.eclipse.ui.IViewActionDelegate</samp> extends <samp>org.eclipse.ui.IActionDelegate</samp> and adds an additional method that allows the |
| delegate to initialize with the view instance it is contributing into. |
| </p> |
| <p> |
| This extension point can be used to contribute actions into menus previously created by the target view. Omitting the menu path attribute will result in adding the new menu or action at the end of the pulldown menu. |
| </p> |
| <p> |
| The enablement criteria for an action extension is initially defined by <samp>enablesFor</samp>, and also either <samp>selection</samp> or <samp>enablement</samp>. However, once the action delegate has been instantiated, it may control the action enable state directly within its <samp>selectionChanged</samp> method. |
| </p> |
| <p> |
| Action and menu labels may contain special characters that encode mnemonics using the following rules: |
| <ol> |
| <li> |
| Mnemonics are specified using the ampersand ('&amp;') character in front |
| of a selected character in the translated text. Since ampersand is not |
| allowed in XML strings, use <samp>&amp;amp;</samp> character entity.</li> |
| </ol> |
| If two or more actions are contributed to a menu or toolbar by a single extension the actions will appear in the reverse order of how they are listed in the plugin.xml file. This behavior is admittedly unintuitive. However, it was discovered after the Eclipse Platform API was frozen. Changing the behavior now would break every plug-in which relies upon the existing behavior. |
| <p> |
| The <samp>selection</samp> and <samp>enablement</samp> elements are mutually exclusive. The <samp>enablement</samp> element can replace the <samp>selection</samp> element using the sub-elements <samp>objectClass</samp> and <samp>objectState</samp>. For example, the following: |
| <pre> |
| <selection |
| class="org.eclipse.core.resources.IFile" |
| name="*.java"> |
| </selection> |
| </pre> |
| can be expressed using: |
| <pre> |
| <enablement> |
| <and> |
| <objectClass name="org.eclipse.core.resources.IFile"/> |
| <objectState name="extension" value="java"/> |
| </and> |
| </enablement> |
| </pre> |
| </documentation> |
| </annotation> |
| |
| <annotation> |
| <appInfo> |
| <meta.section type="implementation"/> |
| </appInfo> |
| <documentation> |
| Each view normally comes with a number of standard items on the pulldown menu and local toolbar. Additions from other plug-ins will be appended to the standard complement. |
| </documentation> |
| </annotation> |
| |
| <annotation> |
| <appInfo> |
| <meta.section type="copyright"/> |
| </appInfo> |
| <documentation> |
| Copyright (c) 2002, 2005 IBM Corporation and others.<br> |
| All rights reserved. This program and the accompanying materials are made |
| available under the terms of the Eclipse Public License v1.0 which accompanies |
| this distribution, and is available at <a |
| href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a> |
| </documentation> |
| </annotation> |
| |
| </schema> |
