org.eclipse.ui.preferencePages 延伸點可讓您提供頁面給一般喜好設定(視窗->喜好設定)對話框。 喜好設定對話框顯示使用者喜好設定項目的階層式清單。選取每一個項目時會顯示一 個對應的喜好設定頁面。
Readme 工具使用這個延伸點來新增 Readme Example 喜好設定頁面。
<extension point = "org.eclipse.ui.preferencePages"> <page id="org.eclipse.ui.examples.readmetool.Page1" class="org.eclipse.ui.examples.readmetool.ReadmePreferencePage" name="%PreferencePage.name"> </page> </extension>
這個標記定義稱為 "Readme Example" 的喜好設定頁面,它由類別 ReadmePreferencePage 實作。該類別必須實作 IWorkbenchPreferencePage 介面。
工作台使用核心執行時期的喜好設定機制來存取喜好設定樹狀結構及其對應頁面中的所有節點。 這份清單可以從喜好設定服務中的資訊來初值設定,而不需要執行任何外掛程式程式碼。
"Readme Example" 喜好設定會新增到左邊喜好設定樹狀結構的最上層。 為什麼呢?因為喜好設定頁面構成要素會新增為樹狀結構的根目錄,除非有指定 category 屬性。(category 這個名稱略有誤導。 path 可能比較正確。)category 屬性指定母項頁面的 ID(或 根目錄中 ID 的順序)。例如,下列標記會建立第二個 Readme 工具喜好設定頁面 "Readme 範例子項頁面",作為程式頁面的子項。
<extension point = "org.eclipse.ui.preferencePages"> <page id="org.eclipse.ui.examples.readmetool.Page1" class="org.eclipse.ui.examples.readmetool.ReadmePreferencePage" name="%PreferencePage.name"> </page> <page id="org.eclipse.ui.examples.readmetool.Page2" class="org.eclipse.ui.examples.readmetool.ReadmePreferencePage2" name="Readme Example Child Page" category="org.eclipse.ui.examples.readmetool.Page1> </page> </extension>
一旦使用者選取左邊樹狀結構中喜好設定頁面的項目,工作台便會利用延伸定義中指定 的類別來建立及顯示喜好設定。這就是啟動外掛程式的動作(如果外 掛程式因另一個使用者作業而尚未啟動)。