blob: 1439e69024005a111bff388ec1209f906e33682b [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD><meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<title>Common Action Provider</title>
<link rel="stylesheet" type="text/css" href="schema.css">
</HEAD>
<BODY>
<H1><CENTER>Common Action Provider</CENTER></H1>
<p></p>
<h6 class=CaptionFigColumn id=header>Identifier: </h6>org.eclipse.wst.common.navigator.views.actionProvder<p></p>
<h6 class=CaptionFigColumn id=header>Since: </h6>[Enter the first release in which this extension point appears.]
<p></p>
<p>
<h6 class=CaptionFigColumn id=header>Description: </h6>[Enter description of this extension point.]<p>
An action's enablement and/or visibility can be defined using the elements <samp>enablement</samp> and <samp>visibility</samp> respectively. These two elements contain a boolean expression that is evaluated to determine the enablement and/or visibility.
<p>
The syntax is the same for the <samp>enablement</samp> and <samp>visibility</samp> elements. Both contain only one boolean expression sub-element. In the simplest case, this will be an <samp>objectClass</samp>, <samp>objectState</samp>, <samp>pluginState</samp>, or <samp>systemProperty</samp> element. In the more complex case, the <samp>and</samp>, <samp>or</samp>, and <samp>not</samp> elements can be combined to form a boolean expression. Both the <samp>and</samp>, and <samp>or</samp> elements must contain 2 sub-elements. The <samp>not</samp> element must contain only 1 sub-element.
</p></p>
<p><h6 class=CaptionFigColumn id=header>Configuration Markup:</h6></p>
<p class=code id=dtd>&lt;!ELEMENT <a name="e.extension">extension</a> (<a href="#e.actionProvider">actionProvider</a>)&gt;</p>
<p class=code id=dtd>&lt;!ATTLIST extension</p>
<p class=code id=dtdAttlist>point&nbsp;CDATA #REQUIRED<p class=code id=dtdAttlist>id&nbsp;&nbsp;&nbsp;&nbsp;CDATA #IMPLIED<p class=code id=dtdAttlist>name&nbsp;&nbsp;CDATA #IMPLIED&gt;</p>
<p></p>
<ul class=ConfigMarkup id=attlistDesc>
</ul>
<br><p class=code id=dtd>&lt;!ELEMENT <a name="e.actionProvider">actionProvider</a> (<a href="#e.enablement">enablement</a> , <a href="#e.emfEnablement">emfEnablement</a>)&gt;</p>
<p class=code id=dtd>&lt;!ATTLIST actionProvider</p>
<p class=code id=dtdAttlist>class&nbsp;CDATA #IMPLIED&gt;</p>
<p></p>
<ul class=ConfigMarkup id=attlistDesc>
<li><b>class</b> - A class which implments the ICommonActionProvider interface.</li>
</ul>
<br><p class=code id=dtd>&lt;!ELEMENT <a name="e.enablement">enablement</a> (<a href="#e.and">and</a> | <a href="#e.or">or</a> | <a href="#e.not">not</a> | <a href="#e.objectClass">objectClass</a> | <a href="#e.objectState">objectState</a> | <a href="#e.pluginState">pluginState</a> | <a href="#e.systemProperty">systemProperty</a>)&gt;</p>
<p></p>
<p class=ConfigMarkup id=elementDesc>
This element is used to define the enablement for the extension.
Objects which are accepted by the expression will cause the ActionProvider to be invoked.</p>
<br><br>
<p class=code id=dtd>&lt;!ELEMENT <a name="e.emfEnablement">emfEnablement</a> (#PCDATA)&gt;</p>
<p></p>
<br><br>
<p class=code id=dtd>&lt;!ELEMENT <a name="e.enablement">enablement</a> (<a href="#e.and">and</a> | <a href="#e.or">or</a> | <a href="#e.not">not</a> | <a href="#e.objectClass">objectClass</a> | <a href="#e.objectState">objectState</a> | <a href="#e.pluginState">pluginState</a> | <a href="#e.systemProperty">systemProperty</a>)&gt;</p>
<p></p>
<p class=ConfigMarkup id=elementDesc>
This element is used to define the enablement for the extension.</p>
<br><br>
<p class=code id=dtd>&lt;!ELEMENT <a name="e.visibility">visibility</a> (<a href="#e.and">and</a> | <a href="#e.or">or</a> | <a href="#e.not">not</a> | <a href="#e.objectClass">objectClass</a> | <a href="#e.objectState">objectState</a> | <a href="#e.pluginState">pluginState</a> | <a href="#e.systemProperty">systemProperty</a>)&gt;</p>
<p></p>
<p class=ConfigMarkup id=elementDesc>
This element is used to define the visibility for the extension.</p>
<br><br>
<p class=code id=dtd>&lt;!ELEMENT <a name="e.and">and</a> (<a href="#e.and">and</a> | <a href="#e.or">or</a> | <a href="#e.not">not</a> | <a href="#e.objectClass">objectClass</a> | <a href="#e.objectState">objectState</a> | <a href="#e.pluginState">pluginState</a> | <a href="#e.systemProperty">systemProperty</a>)&gt;</p>
<p></p>
<p class=ConfigMarkup id=elementDesc>
This element represent a boolean AND operation on the result of evaluating it's two sub-element expressions.</p>
<br><br>
<p class=code id=dtd>&lt;!ELEMENT <a name="e.or">or</a> (<a href="#e.and">and</a> | <a href="#e.or">or</a> | <a href="#e.not">not</a> | <a href="#e.objectClass">objectClass</a> | <a href="#e.objectState">objectState</a> | <a href="#e.pluginState">pluginState</a> | <a href="#e.systemProperty">systemProperty</a>)&gt;</p>
<p></p>
<p class=ConfigMarkup id=elementDesc>
This element represent a boolean OR operation on the result of evaluating it's two sub-element expressions.</p>
<br><br>
<p class=code id=dtd>&lt;!ELEMENT <a name="e.not">not</a> (<a href="#e.and">and</a> | <a href="#e.or">or</a> | <a href="#e.not">not</a> | <a href="#e.objectClass">objectClass</a> | <a href="#e.objectState">objectState</a> | <a href="#e.pluginState">pluginState</a> | <a href="#e.systemProperty">systemProperty</a>)&gt;</p>
<p></p>
<p class=ConfigMarkup id=elementDesc>
This element represent a boolean NOT operation on the result of evaluating it's sub-element expressions.</p>
<br><br>
<p class=code id=dtd>&lt;!ELEMENT <a name="e.objectClass">objectClass</a> EMPTY&gt;</p>
<p class=code id=dtd>&lt;!ATTLIST objectClass</p>
<p class=code id=dtdAttlist>name&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CDATA #REQUIRED<p class=code id=dtdAttlist>adaptable&nbsp;(true | false) &gt;</p>
<p></p>
<p class=ConfigMarkup id=elementDesc>
This element is used to evaluate the class or interface of each object in the current selection. If each object in the selection implements the specified class or interface, the expression is evaluated as true.</p>
<br>
<ul class=ConfigMarkup id=attlistDesc>
<li><b>name</b> - a fully qualified name of a class or interface. The expression is evaluated as true only if all objects within the selection implement this class or interface.</li>
<li><b>adaptable</b> - </li>
</ul>
<br><p class=code id=dtd>&lt;!ELEMENT <a name="e.objectState">objectState</a> EMPTY&gt;</p>
<p class=code id=dtd>&lt;!ATTLIST objectState</p>
<p class=code id=dtdAttlist>name&nbsp;&nbsp;CDATA #REQUIRED<p class=code id=dtdAttlist>value&nbsp;CDATA #REQUIRED&gt;</p>
<p></p>
<p class=ConfigMarkup id=elementDesc>
This element is used to evaluate the attribute state of each object in the current selection. If each object in the selection has the specified attribute state, the expression is evaluated as true. To evaluate this type of expression, each object in the selection must implement, or adapt to, <samp>org.eclipse.ui.IActionFilter</samp> interface.</p>
<br>
<ul class=ConfigMarkup id=attlistDesc>
<li><b>name</b> - the name of an object's attribute. Acceptable names reflect the object type, and should be publicly declared by the plug-in where the object type is declared.</li>
<li><b>value</b> - the required value of the object's attribute. The acceptable values for the object's attribute should be publicly declared.</li>
</ul>
<br><p class=code id=dtd>&lt;!ELEMENT <a name="e.pluginState">pluginState</a> EMPTY&gt;</p>
<p class=code id=dtd>&lt;!ATTLIST pluginState</p>
<p class=code id=dtdAttlist>id&nbsp;&nbsp;&nbsp;&nbsp;CDATA #REQUIRED<p class=code id=dtdAttlist>value&nbsp;(installed|activated) "installed"&gt;</p>
<p></p>
<p class=ConfigMarkup id=elementDesc>
This element is used to evaluate the state of a plug-in. The state of the plug-in may be one of the following: <samp>installed</samp> or <samp>activated</samp>.</p>
<br>
<ul class=ConfigMarkup id=attlistDesc>
<li><b>id</b> - the identifier of a plug-in which may or may not exist in the plug-in registry.</li>
<li><b>value</b> - the required state of the plug-in. The state of the plug-in may be one of the following: <samp>installed</samp> or <samp>activated</samp>.</li>
</ul>
<br><p class=code id=dtd>&lt;!ELEMENT <a name="e.systemProperty">systemProperty</a> EMPTY&gt;</p>
<p class=code id=dtd>&lt;!ATTLIST systemProperty</p>
<p class=code id=dtdAttlist>name&nbsp;&nbsp;CDATA #REQUIRED<p class=code id=dtdAttlist>value&nbsp;CDATA #REQUIRED&gt;</p>
<p></p>
<p class=ConfigMarkup id=elementDesc>
This element is used to evaluate the state of some system property. The property value is retrieved from the <samp>java.lang.System</samp>.</p>
<br>
<ul class=ConfigMarkup id=attlistDesc>
<li><b>name</b> - the name of the system property.</li>
<li><b>value</b> - the required value of the system property.</li>
</ul>
<br><h6 class=CaptionFigColumn id=header>Examples: </h6>[Enter extension point usage example here.]
<p></p>
<h6 class=CaptionFigColumn id=header>API Information: </h6>[Enter API information here.]
<p></p>
<h6 class=CaptionFigColumn id=header>Supplied Implementation: </h6>[Enter information about supplied implementation of this extension point.]
<p></p>
<br>
<p class=note id=copyright>
</p>
</BODY>
</HTML>