提供喜好設定頁面

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 介面。

工作台使用 PreferenceManager 將所有節點的清單保存在喜好設定樹狀結構及其對應頁中。此清單可透過外掛程式登 錄中的資訊起始設定,不需要執行任何外掛程式碼。您喜好設定對話框(左 邊的 "Readme Example" 項目)的外掛程式構成要素會在任何程式碼執行前顯 示。

工作台喜好設定頁面

"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>

一旦使用者選取左邊樹狀結構中喜好設定頁面的項目,工作台便會利用延伸定義中指定 的類別來建立及顯示喜好設定。這就是啟動外掛程式的動作(如果外 掛程式因另一個使用者作業而尚未啟動)。

Copyright IBM Corporation and others 2000, 2003.