說明:這個延伸點係用來為給定類型的物件,新增其他內容頁面。定義好之後,這些內容頁面將出現在該類型之物件的「內容對話框」中。
使用者比較容易使用內容頁面來與物件的內容交談。「內容」檢視畫面會限制物件內容的可用編輯空間, 但內容頁面不會,所以可以自由地定義較大、較複雜且其中含有標籤、圖示等等的控制項。 可邏輯地分在一起的內容可以叢集到一個頁面中,而不必散佈在內容表的各處。不過,在大部份應用程式中,都適合利用內容表來顯示某些物件內容,利用內容頁面來顯示另一些內容。
內容頁面會出現在對話框中,當您在物件的蹦現功能表中選取「內容」功能表項目時,通常會見到它。 除了物件類別之外,也可以選用地提供名稱過濾器來登錄特定物件類型 private 的內容頁面。
如果這些過濾機制都不適當,內容頁面可以使用過濾機制。在這個情況下,會以一系列的鍵值配對來說明目標物件的屬性。 適用於選項的屬性會隨著類型而不同,且會越過工作台本身的領域,因此, 工作台會將這個層次的過濾委派給實際的選項。
配置標記:
<!ELEMENT extension (page*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA
#IMPLIED
name CDATA #IMPLIED
>
<!ELEMENT page (filter*)>
<!ATTLIST page
id CDATA #REQUIRED
name CDATA #REQUIRED
icon CDATA #IMPLIED
objectClass CDATA #REQUIRED
class CDATA #REQUIRED
nameFilter CDATA #IMPLIED
adaptable (true | false)
>
<!ELEMENT filter EMPTY>
這個元素係用來計算現行選擇中每個物件的屬性狀態。 僅在選項中的每一個物件都具有指定的屬性狀態時,才會進行比對。選項中的每一個物件都必須實作或適合於 org.eclipse.ui.IActionFilter。
<!ATTLIST filter
<extension point="org.eclipse.ui.propertyPages"> <page id="com.xyz.projectPage" name="XYZ Java Properties" objectClass="org.eclipse.core.resources.IFile" class="com.xyz.ppages.JavaPropertyPage" nameFilter="*.java"> <filter name="readOnly" value="true"/> </page> </extension>
API 資訊:class 屬性必須指定實作 org.eclipse.ui.IWorkbenchPropertyPage 之類別的完整名稱。
提供的實作方式:工作台所提供的某些物件可能會有登錄過的內容頁面。外掛程式可以新增更多這些物件的內容頁面。 內容頁面不限於工作台資源:工作台所顯示的所有物件(甚至是外掛程式所建立的特定網域 private 物件)也可以有內容頁面, 且其他外掛程式可以登錄它們的內容頁面。
Copyright (c) 2002 IBM Corporation and others.
All rights reserved.
這個程式和伴隨的素材可以根據伴隨這個分送,而且可在 http://www.eclipse.org/legal/cpl-v10.html 中取得的 Common Public License v1.0 的條款來使用