ワークベンチ・メニューの組み込み

ワークベンチでさまざまなメニューおよびツールバーを組み込むいくつかの異なる拡張ポイントを学習してきました。では、どの拡張ポイントを使用すればよいのでしょうか。以下の表では、さまざまなメニュー組み込みとそれらの使用法について要約します。

拡張ポイント名

アクションのロケーション

詳細

viewActions

アクションは、特定のビューのローカル・ツールバーおよびローカル・プルダウン・メニュー内に表示されます。

IViewActionDelegate を実装するアクション・クラスを組み込みます。組み込みの ID およびアクションを表示するターゲット・ビューの ID を指定します。ラベルおよびイメージにより、UI 内のアクションの外観が決まります。パスは、ビューのメニューおよびツールバー項目に関連するロケーションを指定します。

editorActions

アクションは、エディターと関連付けられ、ワークベンチ・メニューおよび (または) ツールバーに表示されます。

IEditorActionDelegate を実装するアクション・クラスを組み込みます。組み込みの ID およびアクションを表示させるターゲット・エディターの ID を指定します。ラベルおよびイメージにより、UI 内のアクションの外観が指定されます。個々のメニューおよびツールバー・パスにより、ワークベンチ・メニューおよびツールバーの組み込みの存在およびロケーションが指定されます。

popupMenus

アクションは、エディターまたはビューのポップアップ・メニューに表示されます。オブジェクト型と関連付けられたアクションは、オブジェクト型を表示するビューおよびエディターのすべてのポップアップに表示されます。特定のポップアップ・メニューと関連付けられたアクションは、そのポップアップ・メニュー内にしか表示されません。

オブジェクト組み込みは、アクションがポップアップ・メニューに表示されるオブジェクトのタイプを指定します。アクションは、そのオブジェクト型を含むすべてのビューおよびエディター・ポップアップに表示されます。  IObjectActionDelegate を実装するアクション・クラスを提供します。 
ビューアー組み込みは、中にメニュー項目が表示されるターゲット・ポップアップ・メニューの ID を指定します。  IEditorActionDelegate または IViewActionDelegate を実装するアクション・クラスを提供します。 

actionSets

アクションは、ワークベンチのメインメニューおよびツールバーに表示されます。アクションは、アクション・セットへグループ化されます。アクション・セットのすべてのアクションは、ユーザーのアクション・セット選択およびワークベンチに表示される現行パースペクティブに応じて、ワークベンチのメニューおよびツールバーに表示されます。  次の actionSetPartAssociations によって影響される場合があります。

IWorkbenchWindowActionDelegate または IWorkbenchWindowPulldownDelegate を実装するアクション・クラスを組み込みます。アクション・セットの名前および ID を指定します。そのアクション・セットに対して定義されたすべてのアクションを列挙します。アクションごとに、個々のメニューおよびツールバー・パスにより、ワークベンチ・メニューおよびツールバーの組み込みの存在およびロケーションが指定されます。

actionSetPartAssociations

アクション・セットは、指定されたビューまたはエディターがアクティブである場合のみ表示されます。  現行パースペクティブをユーザーがカスタマイズしている場合は無視されます。

id によって設定され、アクション・セットを表示するために現行パースペクティブでアクティブにする必要のある 1 つまたは複数のパーツ (id によって) が後に続くアクションを指定します。