当插件使用菜单扩展点之一向工作台用户界面添加操作时,它可以指定菜单项在菜单中可视和/或启用的条件。除了提供简单的启用条件(例如,选择计数和选择类)之外,插件还可以使用布尔表达式来使操作可视或启用它。
布尔表达式可以包含简单布尔运算符(NOT、AND 和 OR)以及可以对下列条件求值的预定义表达式:
objectClass - 如果选择中的每个对象子类化或实现类,则为 true。
objectState - 如果命名属性等于指定的值,则为 true。IActionFilter 帮助对表达式求值。操作过滤器根据目标选择和命名属性的值动态计算操作的启用条件。
systemProperty - 如果命名系统属性等于指定的值,则为 true。
pluginState - 指定应安装还是激活指定的插件(按标识)
例如,下列代码段表示可以用于操作集中试探性操作的启用表达式:
<action id="org.eclipse.examples.actionEnablement.class" label="Red Element" menubarPath="additions" class="org.eclipse.examples.actionEnablement.ObjectTestAction"> <enablement> <and> <objectClass name="org.eclipse.examples.actionEnablement.TestElement"/> <objectState name="name" value="red"/> </and> </enablement> </action>
<action id="org.eclipse.examples.actionEnablement.property" label="Property" menubarPath="additions" class="org.eclipse.examples.actionEnablement.PropertyTestAction"> <enablement> <systemProperty name="MyTestProperty" value="puppy"/> </enablement> </action>
<action id="org.eclipse.examples.actionEnablement.pluginState" label="Installed" menubarPath="additions" class="org.eclipse.examples.actionEnablement.PluginTestAction"> <enablement> <pluginState id="x.y.z.anotherPlugin" value="installed"/> </enablement> </action>
有关这些表达式的更复杂的样本以及 XML 的完整描述,请参阅下面的扩展点参考文档。
下表列示扩展点,它们添加操作并总结可以如何使用 XML 标记属性和布尔表达式来影响启用。
扩展点名称 |
影响启用的属性 |
布尔表达式 |
---|---|---|
enablesFor - 指定要启用操作所必须满足的选择计数 选择类 - 选择的对象必须子类化或实现才能启用操作的类 选择名称 - 可以应用于选择中的各个对象的通配符过滤器。 |
visibility - 布尔表达式。控制菜单项在菜单中是否可视。 enablement - 布尔表达式。控制在菜单中是否启用菜单项。在应用启用表达式之前,必须满足 enablesFor 属性、选择类和名称。 |
|
(仅适用于对象添加项。) objectClass - 指定选择中的各个对象必须子类化或实现的类 (适用于对象和查看器添加项) enablesFor - 指定要启用操作所必须满足的选择计数 选择类 - 选择的对象必须子类化或实现才能启用操作的类 选择名称 - 可以应用于选择中的各个对象的通配符过滤器。
|
(适用于对象和查看器添加项) visibility - 布尔表达式。控制菜单项在菜单中是否可视。 enablement - 布尔表达式。控制在菜单中是否启用菜单项。在应用启用表达式之前,必须满足 enablesFor 属性、选择类和名称。 |
可以将定义内容类型的能力(请参阅内容类型)与布尔表达式组合起来,以便根据资源的内容类型来定义更非常具体的启用或可视性条件。例如,以下片段使得弹出菜单项仅当所选文件的内容与插件的特殊内容类型相匹配时才可视。
<extension point="org.eclipse.ui.popupMenus">
<objectContribution
id="com.example.objectContributions"
objectClass="org.eclipse.core.resources.IFile"
nameFilter="*.xml">
<visibility>
<or>
<objectState
name="contentTypeId"
value="com.example.employeeRecordContentType"/>
<objectState
name="contentTypeId"
value="com.example.customerRecordContentType"/>
</or>
</visibility>
<action id="com.example.action1"
...
contentTypeId 属性可以用于 objectState 表达式中来检查所选
xml 文件的内容类型。这允许插件在启用或显示与特定类型的文件相关的菜单操作之前应用非常具体的内容检查。有关内容类型扩展的更多详细信息,请参阅内容类型。