アクティビティー・サポート

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 インフラストラクチャーが使用できるデータの一部を表します。

以下のヒントは「既知」であり、トリガー・ポイント・アドバイザーによって確認されると予想されます。

interactive
このトリガー・ポイントが「対話式」方法のヒントであるかどうかを示します。つまり、ウィザード・ダイアログでウィザードをアクティブにするなど、ユーザーが実行するアクションによって生じた明示的な結果であるかどうかを示します。有効値は true および false です。



<!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) は、クライアントがサブクラス化および再利用する場合に使用できます。