他の概要部分の実装と同じように 、CustomizableIntroPart を使用するには、基本的な ステップに従って製品にバインドする必要があります。 ただし、この概要部分を使用するには追加のステップ 、つまり「構成」を概要部分にバインドすることが必要です。 概要 を製品にバインドするように、introConfig を customizableIntroPart にバインドする必要があります。以下に、サンプルの構成を示します。
<extension point="org.eclipse.ui.intro.config"> <config id = "static001_configId" introId="org.eclipse.ui.intro.examples.static_introId" content="introContent.xml"> <presentation home-page-id="homePageId" standby-page-id="standbyPageId"> <implementation os="win32" kind="html" /> <implementation kind="swt" /> </presentation> </config> </extension>
上記のコントリビューションでは、configuration は ID org.eclipse.ui.intro.examples.static_introId. を使用して概要部分に登録されます (この概要部分は、 カスタマイズ可能な概要部分インスタンスで、すでに ワークベンチに登録されていることを前提としています)。 この構成は、概要部分に表示されるコンテンツを定義 し、ユーザーへの表示方法を決定します。 コンテンツは XML マークアップ・ファイルの introContent.xml で定義され、表示は マークアップの 2 つの implementation エレメントによって 決定されます。
構成の表示は、SWT ブラウザー・ベース、または
UI 書式ベースの表示のいずれかになります。上記のコントリビューション
では、表示は win32 プラットフォームでは
「HTML」、つまりブラウザー・ベースであり、その他すべての
プラットフォームでは「swt」、つまり UI 書式
ベースになります。 実行時に、
ワークベンチが CustomizableIntroPart のインスタンスを
生成しようとした場合、オペレーティング・システムが
判別され、表示の正しい実装が選択されます。
また、customizableIntroPart によって表示される先頭
ページになるので、home-page-id、つまりルート
・ページを指定する必要があります。また
、standby-page-id も指定される場合、概要
部分が待機モードになった場合に概要部分に表示されます。
コンテンツ・ファイルの詳細は、拡張ポイントの ドキュメンテーションにあります。 例を単純し、静的コンテンツを コントリビュートするために、コンテンツとして以下のものを使用 します。
<?xml version="1.0" encoding="UTF-8" ?> <introContent> <page id="homePageId" url="http://eclipse.org"/> <page id="standbyPageId" url="./static001/standby.html"/> </introContent>
上記のコントリビューションでは、単純な URL がルート・ ページとして使用され、この場合は、URL は eclipse.org Web サイトを指しています。これは 単純にするためです。ルート・ページ は、例えば、Flash のデモをロードするローカルの HTML ファイルなど、どんな HTML ファイルでもかまいません。 また、概要が待機モードになったときに表示される よう定義された待機ページのこともあります。