佈景主題定義了簡介的整體外觀。 它只是將所有呈現檔(樣式和影像)分組到能夠單一指向或切換的位置。
如果要定義佈景主題,請利用 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$
替代變數來建立所有指向樣式和呈現資源的參照。
影像、頁面、樣式等的絕對路徑,將藉由利用目前作用中佈景主題的路徑來解析替代變數,從而計算出來。