プラグインおよびアプリケーション・クラス

プラグインは、OSGi マニフェスト (MANIFEST.MF) ファイルおよびプラグイン・マニフェスト (plugin.xml) ファイルを使用して Eclipse プラットフォーム にその構造を記述する、構造化コンポーネントです。HATS リッチ・クライアント・プロジェクトは、Lotus Notes®、Lotus® Expeditor Client など、Eclipse 環境で実行するプラグインを生成するために必要な成果物を含む、Eclipse プラグイン・プロジェクトです。 プラグイン・プロジェクトは、Eclipse Software Development Kit (SDK) のコンポーネントである、Eclipse プラグイン開発環境 (PDE) を使用して開発します。Rational® Software Delivery Platform (SDP) は Eclipse SDK を拡張したもので、HATS は Rational SDP の拡張をさらに進めたものです。Eclipse PDE について詳しくは、http://www.eclipse.org/pde/ を参照してください。

Eclipse PDE で提供されたツールの 1 つに、プラグインのマニフェスト・エディターがあります。このエディターは、プラグインが実行中の Eclipse 環境に対するプラグインを説明したファイルを修正するために使用されます。プラグインには通常、plugin.xml および MANIFEST.MF の 2 つのマニフェスト・ファイルがあります (プラグインが別のプラグインを拡張しない場合 plugin.xml はオプション)。ワークベンチでどちらかのファイルを開いている場合、同一のエディターが開かれます。ただし、エディターのフィールドは別のファイルと結合されています。plugin.xml は、プラグインがプラットフォームを拡張する方法、プラグインがプラグイン自体を公開する拡張、およびプラグインが機能をインプリメントする方法について記述します。MANIFEST.MF ファイルは、このプラグインが必要な ID、バージョン、ベンダー、および他のプラグインを指定します。

HATS リッチ・クライアント・プロジェクトのプラグイン・マニフェストを編集するには、プロジェクトのプロジェクト設定エディターの「概要」ページにある「プラグイン・マニフェストをオープンしてください」リンクをクリックしてください。エディターには、以下のタブが付いています。

概要
プラグイン ID およびバージョンなど、プラグインの基本属性を変更するためのフィールドが含まれています。
依存関係
このプラグインが必要としているプラグインのリストです。他のプラグインで使用可能な機能を使用する場合は、このタブを使用してプラグインに依存関係を追加します。
ランタイム
このプラグインに応じて、プラグインで使用可能な Java™ パッケージのリストを表示します。
拡張
このプラグインによって拡張される拡張ポイントを表示します。
拡張ポイント
HATS リッチ・クライアント・プラグインによって定義されている拡張ポイントを表示します。デフォルトで、HATS リッチ・クライアント・プラグインには拡張ポイントは定義されていません。
ビルド
エクスポート操作中にこのプラグインが作成されるときに、どのファイルを組み込むかを構成できます。他のファイルをこのプラグインに追加する場合、このリストを変更する必要があります。
注:
  1. 非 Java ソース・ファイルをプラグイン・プロジェクトに追加する場合、プラグインの build.properties ファイルを更新する必要があります。build.properties ファイルは、プロジェクトがプラグインとしてエクスポートされたときに、どのファイルが組み込まれるかを制御します (デプロイメントの第一ステップ)。このファイルは、プラグイン・プロジェクトのルートに配置され、プラグインのマニフェスト・エディターを使用して編集できます。
  2. プラグイン・プロジェクトで新規フォルダーを作成した場合、 フォルダーを「ビルド」タブに追加しないかぎり、プラグインをエクスポートしても新規フォルダは配置されません。
MANIFEST.MF
プラグイン MANIFEST.MF ファイルのソース・ビューを表示します。ソースを直接編集するよりも、「概要」タブ、「依存関係」タブ、および「ランタイム」タブを使用して、このファイルを変更します。
plugin.xml
plugin.xml ファイルのソース・ビューを表示します。「拡張」タブおよび「拡張ポイント」タブを使用して、このファイルを変更します。
build.properties
build.properties ファイルを表示します。「ビルド」タブを使用して、このファイルを変更する必要があります。

プラグイン・プロジェクトの拡張ポイント

プラグインが、他のプラグインによる機能部分の拡張またはカスタマイズを許可する場合、拡張ポイントを宣言します。拡張ポイントは、通常は XML マークアップと Java インターフェースの組み合わせの、拡張が準拠する規約を宣言します。この拡張ポイントに接続するプラグインは、その拡張にこの規約をインプリメントする必要があります。拡張されるプラグインが、その拡張ポイント規約のスコープを超えて接続しているプラグインに関してはなにも認識しない、ということがキー属性になっています。これによって、異なる個人または企業によって作成されるプラグインは、お互いをよく認識しなくても、シームレスに対話することができます。

com.ibm.hats.rcp.runtime.rcpApplications 拡張機能は、使用する HATS リッチ・クライアント・プラグインを HATS ランタイムに登録します。こうすることにより、HATS ランタイムは、どのプラグインが HATS アプリケーション・プラグインなのかを認識します。「アプリケーション」ビューは、この拡張ポイントをインプリメントするプラグインに基づいて移植されます。この拡張ポイントも、アプリケーションのインスタンスが起動されたときに、どのビュー (デフォルトでユーザーの変換ビュー) が開くのかを示しています。

HATS RCP プロジェクトは Eclipse org.eclipse.ui.views 拡張を使用して、このプラグインの変換ビュー・クラスを Eclipse プラットフォームに登録します。

アプリケーションのインスタンスの 1 つのみの許可

デフォルトでは、ユーザーはアプリケーションの変換ビューの複数インスタンスを開くことで、HATS リッチ・クライアント・アプリケーションの複数インスタンスを一度に処理できます。ユーザーがアプリケーションの複数インスタンスを始動することを制限するために、プラグイン・プロジェクトのプラグイン・マニフェスト・ファイル (plugin.xml) にフラグを設定することができます。このフラグによって、Eclipse はアプリケーションのビューのインスタンスを 1 つのみ許可するよう通知します。このフラグを設定するには、以下を行います。

  1. プロジェクト設定エディターの「概要」ページにある「プラグイン・マニフェストをオープンしてください」をクリックして、プロジェクトのプラグイン・マニフェスト・ファイルを開きます。
  2. 「拡張」タブをクリックします。
  3. 「すべての拡張」ツリーで、org.eclipse.ui.views ノードを展開して、プロジェクトに対応するノードを選択します。デフォルトでは、1 つのビューだけがリストされています。
  4. 「拡張エレメント詳細」セクションで、allowMultiple 設定を true から false に変更します。
  5. ファイルを保管します。

注:
アプリケーションが実行中にプラグイン・マニフェスト・ファイルを変更した場合、ランタイム・ワークベンチの再始動が必要です。

ランタイム時にユーザーがアプリケーションの 2 番目のインスタンスを開こうとすると、最初のアプリケーション・インスタンスに対応するビューがフォーカスされます。

HATS ランタイム拡張プラグイン

HATS リッチ・クライアント・プラグイン・プロジェクトを作成するときに、ワークスペースに HATS リッチ・クライアント・ランタイム拡張プラグイン・プロジェクトがまだ存在していない場合には、このプロジェクトも作成されます。このプラグインには、環境で実行中のすべての HATS リッチ・クライアント・プラグインに共通するファイルおよび設定が含まれています。 たとえば以下のものがあります (これらに制限されません)。

このプラグインのデフォルト名および ID は com.ibm.hats.rcp.runtime.extension で、その初期バージョンは 1.0.0 です。

注:
HATS RCP ランタイム拡張プラグインの ID は、変更しないでください。HATS ランタイムは、開始時に、この ID を持つプラグインを検索します。

このプラグインは、複数の HATS アプリケーションに共通のファイルを含んでいるという点で、HATS EAR プロジェクトと似ています。HATS EAR プロジェクトと異なる点は、Eclipse 環境で一度に実行できるのが、これらのプラグインの 1 つのみということです。つまり、トレース設定やキーボード・マッピングなどはリッチ・クライアント環境全体に適用され、プラグイン・プロジェクト・レベルでは構成できません。

表 1 では、このプラグインに含まれているファイルがリスト表示され、説明されています。

表 1. ランタイム拡張プラグインの HATS 固有ファイル
ファイルまたはフォルダー 説明
イメージ (フォルダー) 「アプリケーションおよび印刷ジョブ」ビューのイメージおよび Expeditor アプリケーションのイメージが含まれています。
注:
たとえばイメージが単一の HATS アプリケーション・プラグインによってのみ使用される場合、イメージをテンプレートに含めるには、ランタイム拡張プラグインの代わりにアプリケーション・プラグインに含めることを検討してください。
ログ (フォルダー) HATS トレースおよびメッセージ・ファイルが含まれています。
product.xml このプラグイン・プロジェクトを生成するために使用した HATS のバージョンを示します。このファイルは、Service Pack の適用時に更新されます。
runtime.properties HATS ランタイム設定。トレースを使用可能にする設定が含まれています。
runtime-debug.properties runtime.properties と同じ設定です。ただし、Eclipse ランタイム・ワークベンチがデバッグ・モードで起動したときのみ使用されます。

表 2 では、このプラグインに含まれている HATS 固有ではないファイルがリスト表示され、説明されています。

表 2. ランタイム拡張プラグイン内の HATS 固有でないファイル
ファイルまたはフォルダー 説明
build.properties 開発環境からのエクスポート時に、どのファイルをプラグインにパッケージする必要があるかを示しています。
MANIFEST.MF プラグイン記述子。プラグインの ID、名前、バージョン、およびプラグイン依存関係が示されています。
plugin.xml プラグイン記述子。このプラグインによって提供される拡張を示しています。
plugin_xx.properties plugin.xml および MANIFEST.MF によって使用される変換済み文字列が含まれています。

表 3 は、HATS RCP ランタイム拡張プラグインによって提供されている拡張をリスト表示します。

表 3. RCP ランタイム拡張
拡張ポイント ID 説明
org.eclipse.core.runtime.applications HATS RCP ランタイム拡張プラグインで提供されているアプリケーション・クラスを Eclipse プラットフォームに登録します。詳細については、Application クラスを参照してください。
org.eclipse.core.runtime.products org.eclipse.core.runtime.applications 拡張ポイントに登録されているアプリケーションを参照する製品を定義します。詳細については、Application クラスを参照してください。
org.eclipse.ui.perspectives Eclipse プラットフォームに、HATS RCP ランタイム拡張プラグインで提供されている ホスト・アクセス・パースペクティブ・クラスを登録します。 パースペクティブおよびビューを参照してください。
org.eclipse.ui.views 「アプリケーションおよび印刷ジョブ」ビューを Eclipse プラットフォームに登録します。
org.eclipse.ui.propertyPages アプリケーションのプロパティー・ページを Eclipse プラットフォームに登録します。 これらのページは、ユーザーが「アプリケーション」ビューでアプリケーションを右クリックし、「プロパティー」を選択したときに表示されます。この宣言を除去またはコメント化することによって、ユーザーがこのページを使用できないようにすることが可能です。
注:
「接続パラメーターのオーバーライド」ページは、接続パラメーターの指定変更がプロジェクトで使用可能になっている場合のみ表示されます。「変数オーバーライド」ページは、グローバル変数の指定変更がプロジェクトで使用可能になっている場合のみ表示されます。
org.eclipse.ui.actionSets 変換ビューに表示されている項目を印刷するために使用する印刷アクションを登録します。
org.eclipse.ui.preferencePages HATS によって提供されている設定ページを登録します。プリファレンスは、(Eclipse の環境に応じて) 通常「ファイル」>「設定」または「ウィンドウ」>「設定」を選択することによって使用可能になります。この宣言を除去またはコメント化することによって、ユーザーがこのページを使用できないようにすることが可能です。例えば、ユーザーがトレースまたはサービス設定を変更できなくするには、「トラブルシューティング」ページに宣言されている拡張を除去します。
org.eclipse.ui.contexts Host Access キーボード・コンテキストを登録します。コンテキストは、関連するコマンドのグループを定義します。
org.eclipse.ui.commands 使用可能なアクションごとに、コマンドを登録します。コマンドは、アクションによって処理可能な、エンド・ユーザーからの要求を表しています。
org.eclipse.ui.bindings 特定のコマンドに対するデフォルト・キーボード・ショートカットを登録します。宣言の sequence 属性を変更することによって、コマンドのデフォルト・ショートカットを変更できます。ユーザーは、「キー」設定ページを使用して、コマンドのショートカットを指定変更できます。

キー・マッピングは、目的のランタイム・クライアントに基づき、スキーム ID ごとに定義します。Eclipse RCP と Lotus Expeditor Client の両方に関する schemeId を以下に示します。

org.eclipse.ui.defaultAcceleratorConfiguration.

Lotus Notes の schemeId を以下に示します。

com.ibm.workplace.notes.hannoverConfiguration.
注:
例については、「HATS ユーザーと管理者のガイド」のセクション『HATS リッチ・クライアント・アプリケーションのキーの再マップ』を参照してください。
com.ibm.eswe.workbench.WctApplication Host Access パースペクティブを Lotus Expeditor Client および Lotus Notes に登録します。この拡張ポイントは、「開く」メニューに表示されるアプリケーションのリストにデータを取り込むために、Lotus Expeditor Client および Lotus Notes によって使用されます。詳細は、Lotus Expeditor 資料の『アプリケーション』を参照してください。
注:
この宣言は、Lotus Expeditor Client または Lotus Notes へのデプロイメントをターゲットとするプロジェクトがワークスペースにない場合、表示されません。

Application クラス

このセクションで説明されているクラスは、Eclipse リッチ・クライアント・プラットフォーム環境の始動および構成を行います。これらのクラスの機能およびデフォルトのインプリメンテーションの詳細については、http://www.eclipse.org/documentation/ にある Eclipse 資料を参照し、ご使用の Eclipse のバージョンを選択し、『Building a Rich Client Platform application』という名前のセクションを検索してください。

注:
HostAccessApplication、HostAccessWorkbenchAdvisor、 HostAccessWorkbenchWindowAdvisor、および HostAccessActionBarAdvisor クラスは、Eclipse が構成されている場合のみ、製品構成の一部として、または開始パラメーターによって使用されます。これは、HATS RCP ランタイム拡張プラグインに定義されているアプリケーションまたは製品を使用することが目的です。これらのクラスは、このプラグインが Lotus Expeditor Client または Lotus Notes で実行中の場合は使用されません。これは、これらの製品が、固有のアプリケーション・クラスを使用しているためです。

HostAccessApplication

Eclipse アプリケーション・クラスは、Eclipse 環境のメイン・エントリー・ポイントです。Eclipse プラットフォームが始動すると、指定したアプリケーションを検出してロードします。

デフォルト・アプリケーション・クラス (HostAccessApplication) は、HATS RCP ランタイム拡張プラグイン・プロジェクトに提供されています。このクラスは、提供された HostAccessWorkbenchWindowAdvisor クラスにより構成される新規ワークベンチ・ウィンドウを作成します。

注:
デフォルト・アプリケーション・クラスは簡単なものであるため、通常では変更の必要はありません。

提供されているアプリケーションを Eclipse 環境インスタンスのメイン・エントリー・ポイントとして使用するには、以下のように、アプリケーション引数にアプリケーションの ID を指定します。

Windows®:
eclipse.exe -application com.ibm.hats.rcp.runtime.extension.application
Linux®:
./eclipse -application com.ibm.hats.rcp.runtime.extension.application

Eclipse 製品は、Eclipse 環境をブランド化します。ブランド化には、「製品情報」ダイアログの定義、ウィンドウ・アイコンの設定、デフォルト・プリファレンスの定義、プラットフォーム始動時に表示されるスプラッシュ画面の指定などがあります。ブランド化の詳細については、http://www.eclipse.org/documentation/ にある Eclipse 資料を参照し、ご使用の Eclipse のバージョンを選択し、『Customizing a product』という名前のセクションを検索してください。 デフォルトの製品は、HATS ランタイム拡張プラグイン (com.ibm.hats.rcp.runtime.extension.product) に定義されています。この製品を使用して Eclipse プラットフォームを始動するには、以下のように製品の引数の製品 ID を指定します。

Windows:
eclipse.exe -product com.ibm.hats.rcp.runtime.extension.product
Linux:
./eclipse -product com.ibm.hats.rcp.runtime.extension.product

製品の拡張ポイントが、使用するアプリケーションを示すため、製品の指定時にアプリケーションを指定する必要はありません。HATS ランタイム拡張プラグイン製品の場合、HATS ランタイム拡張プラグイン・アプリケーションがデフォルトで使用されます。

HostAccessWorkbenchAdvisor

Eclipse WorkbenchAdvisor クラスは、デフォルトのパースペクティブを指定して、WorkbenchWindowAdvisor オブジェクトを構築します。このオブジェクトはワークベンチ・ウィンドウを構成します。このクラスのインプリメンテーションは、HATS RCP ランタイム拡張プラグインに提供されています。このクラス HostAccessWorkbenchAdvisor は、HostAccessWorkbenchWindowAdvisor オブジェクトの新規インスタンスを戻し、デフォルトのパースペクティブとして hostaccess.perspectives.main を指定します。これが、新規ワークベンチ・ウィンドウが開くときに、Host Access パースペクティブがデフォルトで表示される理由です。カスタム・パースペクティブを作成している場合、getInitialWindowPerspectiveId() メソッドを更新して、このパースペクティブの ID を戻すことができます。代わりに、-perspective 引数を使用して Eclipse が起動されるときに、以下のようにパースペクティブを指定することもできます。

Windows:
eclipse.exe -product com.ibm.hats.rcp.runtime.extension.product -perspective myCompany.myCustomPerspective
Linux:
./eclipse -product com.ibm.hats.rcp.runtime.extension.product -perspective myCompany.myCustomPerspective

注:
Eclipse 3.1 より前は、WorkbenchAdvisor クラスはワークベンチの初期化、ワークベンチ・ウィンドウの構成、メニュー・バーおよびツールバーのアクションの作成を行っていました。これらの機能は、現在では次の 3 つのクラス、すなわち WindowAdvisor、WorkbenchWindowAdvisor、および ActionBarAdvisor に分割されています。

HostAccessWorkbenchWindowAdvisor

Eclipse WorkbenchWindowAdvisor クラスは、サイズ、位置、およびスタイルを含む、Eclipse ワークベンチ・ウィンドウの構成を行います。このクラスのインプリメンテーションは、HATS RCP ランタイム拡張プラグインに提供されています。このクラス (HostAccessWorkbenchWindowAdvisor) は、ワークベンチ・ウィンドウの初期サイズを指定し、クールバーおよび状況表示行域を非表示にします。これは、HATS はデフォルトではこれらの領域に寄与しないためです。

このクラスは、アクション・バー・アドバイザーを作成することもできます。アクション・バー・アドバイザーは、主に、ワークベンチ・ウィンドウのメニュー・バーを構成します。ワークベンチ・ウィンドウのメニュー・バーおよびツールバーのカスタマイズについて詳しくは、HostAccessActionBarAdvisorを参照してください。

ワークベンチ・ウィンドウのサイズの制御

ワークベンチ・ウィンドウのデフォルト・サイズを変更するには、以下の手順に従います。

  1. 「ナビゲーター」ビューまたは「パッケージ・エクスプローラー」ビューから、com.ibm.hats.rcp.runtime.extension プラグイン・プロジェクトの hostaccess パッケージに配置されている HostAccessWorkbenchWindowAdvisor クラスを開きます。
  2. preWindowOpen() メソッドを見つけ、IWorkbenchWindowConfigurer オブジェクトの setInitializeSize メソッドに渡されたパラメーターを変更します。例えば、初期ウィンドウ・サイズの幅を 800 ピクセル、高さを 600 ピクセルに設定するには、以下のコードを更新または追加します。
    public void preWindowOpen() {
        IWorkbenchWindowConfigurer configurer = getWindowConfigurer();
        configurer.setInitialSize(new Point(800, 600));
        ...        
    }

ワークベンチ・ウィンドウを開くときに、デフォルトで自動的に最大化するには、HostAccessWorkbenchWindowAdvisor クラスの postWindowCreate() メソッドを以下のようにインプリメントします。

public void postWindowCreate() {
    PlatformUI.getWorkbench().getActiveWorkbenchWindow().
                    getShell().setMaximized(true);       
}
注:
参照されている 1 つ以上のクラスが解決できない場合、このクラスのインポート・セクションを更新する必要があります。インポート・セクションを自動的に更新するには、ソース・ファイルのエディターの内部を右クリックして、「ソース」>「インポートの編成」を選択します。

パースペクティブ・バーの表示

パースペクティブ・バーはワークベンチ・ウィンドウの上部付近にあり、既に開いた状態のパースペクティブに素早くアクセスできるほか、エンド・ユーザーは新規パースペクティブを開くこともできます。パースペクティブ・バーを表示すれば、エンド・ユーザーは他のパースペクティブを素早く簡単に処理できるようになります。パースペクティブ・バーを表示するには、以下を行います。

  1. 「ナビゲーター」ビューまたは「パッケージ・エクスプローラー」ビューから、com.ibm.hats.rcp.runtime.extension プラグイン・プロジェクトの hostaccess パッケージに配置されている HostAccessWorkbenchWindowAdvisor クラスを開きます。
  2. preWindowOpen() メソッドを見つけ、IWorkbenchWindowConfigurer オブジェクトの setShowPerspectiveBar メソッドを true で呼び出すようにメソッドを更新します。
    public void preWindowOpen() {
    IWorkbenchWindowConfigurer configurer = getWindowConfigurer();
    configurer.setShowPerspectiveBar(true);
    ... 
    }

HostAccessActionBarAdvisor

Eclipse ActionBarAdvisor クラスは、ワークベンチ・ウィンドウのアクション・バー (ツールバー、クールバー、メニュー・バー、状況表示行) を構成します。このクラスのインプリメンテーションは、HATS RCP ランタイム拡張プラグインに提供されています。このクラス HostAccessActionBarAdvisor は、「ファイル」メニューの項目を含むメニュー・バーのアクションを作成します。

表 4 では、HostAccessActionBarAdvisor クラスによってインプリメント、または拡張可能なメソッドをリスト表示します。

表 4. HostAccessActionBarAdvisor クラス・メソッド
メソッド 説明
makeActions(IWorkbenchWindow window) アクション・オブジェクトは、このメソッドに作成し、初期化する必要があります。
fillMenuBar(IMenuManager) ワークベンチ・ウィンドウのメニュー・バーを、メニューおよびサブメニューに配置します。このメソッドの現行のインプリメンテーションでは、「ファイル」、「ウィンドウ」、および「ヘルプ」メニューを作成し、配置します。メニューに表示された状態のアクションを非表示にするために、アクションを MenuManager に追加しないでください。たとえば、「印刷」アクションを非表示にするには、次の行を fillMenuBar() メソッドから除去します。
fileMenu.add(printAction);
注:
fillMenuBar() メソッドは、ワークベンチの IWorkbenchWindowConfigurer が、メニュー・バーを表示するよう指定している場合にのみ、適用されます。
fillCoolBar(ICoolBarManager) ワークベンチ・ウィンドウのクールバーに項目を配置します。
注:
fillCoolBar() メソッドは、ワークベンチの IWorkbenchWindowConfigurer が、クールバーを表示するよう指定している場合にのみ、適用されます。

ワークベンチ・ウィンドウ・ツールバーのカスタマイズ

HostAccessActionBarAdvisor クラスを拡張する方法を例示するために、以下の手順では、ツールバー項目をワークベンチ・ウィンドウのメイン・クールバー領域に追加する方法を示します。クリックすると、指定した HATS リッチ・クライアント・アプリケーションの新規インスタンスが開きます。

  1. HostAccessWorkbenchWindowAdvisor.preOpen() メソッドを更新して、ワークベンチ・ウィンドウのクールバー領域を表示します。このメソッドは、既にインプリメントされています。このため、行う必要があるのは、以下のように、呼び出しを setShowCoolBar(boolean) メソッドに追加することだけです。
        public void preWindowOpen() {
            ...
            configurer.setShowCoolBar(true);
            ...
        }
  2. 以下のように、新規プライベート・メンバーを HostAccessActionBarAdvisor に追加します。
    private LaunchApplicationAction launchAppAction;
  3. コードを HostAccessActionBarAdvisor.makeActions() メソッドに追加して、LaunchApplicationAction クラスの新規インスタンスを作成します。このクラスのコンストラクターは、以下のように 2 つの引数を受け入れます。
    1. HATS リッチ・クライアント・アプリケーションの ID
    2. IWorkbenchWindow オブジェクト (makeActions() メソッドに引き渡されます。)
          protected void makeActions(final IWorkbenchWindow window) {
              ...
              launchAppAction = new LaunchApplicationAction("myPlugin", window);
          }
  4. ApplicationActionBarAdvsior.fillCoolBar() メソッドを追加または更新して、ツールバーを作成し、新規ランチャー・アクションをそのツールバーに追加して、次にそのツールバーをクールバーに追加します。
    protected void fillCoolBar(ICoolBarManager coolBar) {
        // Create toolbar manager
        IToolBarManager mainToolbar = new ToolBarManager(SWT.FLAT | SWT.RIGHT);
        // Add the launch action to the toolbar manager
        mainToolbar.add(launchAppAction);
                
        // Add the main toolbar to the window coolbar
        coolBar.add(new ToolBarContributionItem(mainToolbar, "main"));   
    
    }
  5. 新規 Eclipse ワークベンチを起動します。このプラグインに関連付けられている変換ビューの新規インスタンスを、(クリックすることによって) 開く新規ツールバー項目が必要です。
図 1. 新規ワークベンチの起動
新規ワークベンチの起動
注:
launchAppAction オブジェクトで setText() メソッドおよび setImageDescriptor() メソッドを呼び出すことによって、起動アクション用に表示されるデフォルトのイメージおよびテキストの両方を変更できます。org.eclipse.jface.action.Action クラスについて詳しくは、Eclipse API を参照してください。