イントロ・テーマの定義

テーマは、イントロの全体的な外観 を定義するものです。ただ単に、すべてのプレゼンテーション・ファイル (スタイルとイメージ) を、 1 つの場所にグループ化し、1 つのものとして指定または切り替えることができるようにするためのものです。

定義

テーマを定義するには、以下の例に示すように org.eclipse.ui.intro.configExtension を使用してイントロ構成を拡張し、theme 要素を使用します。

   <extension
         point="org.eclipse.ui.intro.configExtension">
<theme
            default="true"
            id="org.eclipse.ui.intro.universal.circles"
            name="%theme.name.circles"
            path="$nl$/themes/circles"
            previewImage="themes/circles/preview.png">
    <property 
               name="launchbarBackground"
               value="#a1c2cb"/>
    <property 
               name="launchbarOverviewIcon"
               value="$theme$graphics/launchbar/overview16.png"/>
    <property 
               name="launchbarFirststepsIcon"
               value="$theme$graphics/launchbar/firststeps16.png"/>
    <property 
               name="launchbarTutorialsIcon"
               value="$theme$graphics/launchbar/tutorials16.png"/>
    <property 
               name="launchbarSamplesIcon"
               value="$theme$graphics/launchbar/samples16.png"/>
    <property 
               name="launchbarWhatsnewIcon"
               value="$theme$graphics/launchbar/whatsnew16.png"/>
    <property 
               name="launchbarMigrateIcon"
               value="$theme$graphics/launchbar/migrate16.png"/>
    <property 
               name="launchbarWebresourcesIcon"
               value="$theme$graphics/launchbar/webresources16.png"/>
      </theme>
   </extension>

テーマ関係の使用可能な全属性について詳しくは、 スキーマ・ドキュメンテーションを参照してください。

各テーマには、固有の ID、翻訳可能な名前、プレビュー・イメージ、およびルート・テーマ・フォルダーへのパスがあります。イントロ・プラグインは、テーマ操作用の UI を提供しません。テーマを選択する唯一の方法は、plugin_customization.ini の設定 org.eclipse.ui.intro/INTRO_THEME を使用する方法です。

テーマの使用可能化

テーマ・サポート自体は、イントロ実装をテーマ対応にはしません。具体的なイントロ実装では、テーマをより実質的な方法で公開するようにすることができます。実際に、Universal Welcome 実装では、 一般」>「ようこそ設定ページを使用してこれを正確に行っています。

テーマ対応のイントロ実装では、$theme$ 置換変数を使用して、スタイル・リソースおよびプレゼンテーション・リソースへのすべての参照を作成する必要があります。イメージ、ページ、スタイルなどに対する絶対パスは、現在アクティブなテーマのパスを使用して置換変数を解決することで計算されます。