活動支援

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) 可供用戶端繼承和重複使用。