如同任何簡介組件的實作一樣,若要使用 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>
在上述構成要素中,以 ID 為 org.eclipse.ui.intro.examples.static_introId 的簡介組件 登錄了一個配置。(假設這個簡介組件是個可自訂的簡介組件實例,且已向工作台登錄。)這個配置定義了要呈現在簡介組件中的內容,並指出呈現給使用者的方式。 其內容會定義在 XML 標記檔 introContent.xml 中,而呈現方式則是由標記中的兩個 implementation 元素來指定。
配置呈現方式可以是 SWT 瀏覽器型或 UI 表單型的呈現方式。在上述構成要素中,win32 平台的呈現方式會是 "html",也就是瀏覽器型;
而所有其他平台則是 "swt",也就是 UI 表單型。在執行時期,當工作台嘗試建立 CustomizableIntroPart 的實例時,會判斷作業系統並選擇呈現方式正確的實作。
同時,也需要指定 home-page-id 或根頁面,因為這會是 customizableIntroPart 所顯示的第一個頁面。如果也指定了 standby-page-id,當簡介組件處於待命模式時,
它會顯示在簡介組件中。
內容檔的詳細資料位於延伸點文件中。作為簡單的範例以及提供靜態內容,我們會使用以下內容:
<?xml version="1.0" encoding="big5" ?> <introContent> <page id="homePageId" url="http://eclipse.org"/> <page id="standbyPageId" url="./static001/standby.html"/> </introContent>
在上述構成要素中,使用了一個簡單的 URL 作為根頁面,在本例中則是指向 eclipse.org 網站的 URL。這是為了簡化起見。根頁面可以是任何 HTML 檔,比方說,會載入 flash 展示畫面的本端 HTML 檔。它也定義了一個待命頁面,該頁面會在簡介進入待命模式時顯示。