定義簡介佈景主題

佈景主題定義了簡介的整體外觀。 它只是將所有呈現檔(樣式和影像)分組到能夠單一指向或切換的位置。

定義

如果要定義佈景主題,請利用 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、可翻譯的名稱、預覽影像,以及通往根佈景主題資料夾的路徑。 簡介外掛程式並未提供任何用來操作佈景主題的使用者介面。 透過 plugin_customization.ini 中的 org.eclipse.ui.intro/INTRO_THEME 喜好設定,是選取佈景主題的唯一方法。

啟用佈景主題

佈景主題本身並不會使簡介實作啟用佈景主題。 具體的簡介實作可以選擇以更基本的方式來顯現佈景主題(事實上,Universal Welcome 實作會利用一般 > 歡迎使用喜好設定頁面來確實執行這個動作)。

啟用佈景主題的簡介實作必須利用 $theme$ 替代變數來建立所有指向樣式和呈現資源的參照。 影像、頁面、樣式等的絕對路徑,將藉由利用目前作用中佈景主題的路徑來解析替代變數,從而計算出來。