活动支持

org.eclipse.ui.activitySupport

3.1

此扩展点用来注册与活动基础结构相关的各种支持扩展。

<!ELEMENT extension (triggerPoint | triggerPointAdvisor | triggerPointAdvisorProductBinding | categoryImageBinding | activityImageBinding)*>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT triggerPoint (hint*)>

<!ATTLIST triggerPoint

id CDATA #REQUIRED>

指定触发器点。触发器点是一个标识,由活动引擎用来确定操作是否导致启用了活动。



<!ELEMENT hint EMPTY>

<!ATTLIST hint

id    CDATA #REQUIRED

value CDATA #REQUIRED>

hint(提示)表示某些数据,eclipse 基础结构可以使用这些数据来确定与主管触发器点相关的活动支持的行为。

以下提示是“公认”的,预计触发器点顾问程序会认可它们:

interactive
此触发器点是否是“交互式”方式的提示。即,它是由用户执行的操作的显式结果,例如在向导对话框中激活向导。接受的值为 truefalse



<!ELEMENT triggerPointAdvisor EMPTY>

<!ATTLIST triggerPointAdvisor

id    CDATA #REQUIRED

class CDATA #REQUIRED>

触发器点顾问程序是一种策略机制,无论系统何时执行已禁用与该机制相关联的活动的操作,都要参照该机制。顾问程序负责应答操作是否应该继续,如果可以继续,则要启用哪些活动。



<!ELEMENT triggerPointAdvisorProductBinding EMPTY>

<!ATTLIST triggerPointAdvisorProductBinding

productId             CDATA #REQUIRED

triggerPointAdvisorId CDATA #REQUIRED>

指定产品与顾问程序之间的绑定。这些绑定确定哪个顾问程序适用于当前产品(按照 org.eclipse.core.runtime.Platform.getProduct() 的定义)。



<!ELEMENT categoryImageBinding EMPTY>

<!ATTLIST categoryImageBinding

id   CDATA #REQUIRED

icon CDATA #REQUIRED>

此元素允许将图标绑定至类别。这些图标可供希望以某种方式使类别直观化的用户界面组件使用。



<!ELEMENT activityImageBinding EMPTY>

<!ATTLIST activityImageBinding

id   CDATA #REQUIRED

icon CDATA #REQUIRED>

此元素允许将图标绑定至活动。这些图标可供希望以某种方式使活动直观化的用户界面组件使用。



以下是非交互式触发器点的一个示例:

  

<extension point=

"org.eclipse.ui.activitySupport"

>

<triggerPoint id=

"com.example.xyz.myTriggerPoint"

>

<hint id=

"interactive"

value=

"false"

/>

</triggerPoint>

</extension>

以下是已绑定至特定产品的触发器点顾问程序的一个示例:

  

<extension point=

"org.eclipse.ui.activitySupport"

>

<triggerPointAdvisor id=

"com.example.xyz.myTriggerPointAdvisor"

class=

"com.example.xyz.AdvisorImpl"

/>

<triggerPointAdvisorProductBinding productId=

"myProduct"

triggerPointAdvisorId=

"com.example.xyz.myTriggerPointAdvisor"

/>

</extension>

以下是将图像绑定至活动和类别的一个示例:

  

<extension point=

"org.eclipse.ui.activitySupport"

>

<activityImageBinding id=

"some.activity.id"

icon=

"icons/someIcon.gif"

/>

<categoryImageBinding id=

"some.category.id"

icon=

"icons/someIcon.gif"

/>

</extension>

triggerPointAdvisor 标记的 class 属性的值必须是实现 org.eclipse.ui.activities.ITriggerPointAdvisor 的类的标准名称。

工作台实现(org.eclipse.ui.activities.WorkbenchTriggerPointAdvisor)可供客户机划分子类并复用。