CustomizableIntroPart での静的 HTML コンテンツの表示

他の概要部分の実装と同じように 、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 ファイルでもかまいません。 また、概要が待機モードになったときに表示される よう定義された待機ページのこともあります。