活動支援

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>

指定觸發點。觸發點是活動引擎用來判斷某動作是否應導致活動啟用的 ID。



<!ELEMENT hint EMPTY>

<!ATTLIST hint

id    CDATA #REQUIRED

value CDATA #REQUIRED>

提示代表部分 Eclipse 基礎架構可能用來決定與代管觸發點相關的活動支援行為資料。

以下提示為「廣為人知」的,且預期觸發點警告器能接受這些提示:

交談式
是否以「交談式」方式提示此觸發點。也就是:這是一個由使用者所進行的動作之明確結果,例如在精靈對話框中啟動精靈。可接受的值為 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) 可供用戶端進行繼承與重新使用。