「內容」頁面

org.eclipse.ui.propertyPages

這個延伸點係用來為給定類型的物件,新增其他內容頁面。定義好之後,這些內容頁面將出現在該類型之物件的「內容對話框」中。

使用者比較容易使用內容頁面來與物件的內容交談。「內容」視圖會限制物件內容的可用編輯空間, 但內容頁面不會,所以可以自由地定義較大、較複雜且其中含有標籤、圖示等等的控制項。 可邏輯地分在一起的內容可以叢集到一個頁面中,而不必散佈在內容表的各處。不過,在大部分應用程式中,都適合利用內容表來顯示某些物件內容,利用內容頁面來顯示另一些內容。

內容頁面會出現在對話框中,當您在物件的蹦現功能表中選取「內容」功能表項目時,通常會見到它。 除了物件類別之外,也可以選用地提供名稱過濾器來登錄特定物件類型 private 的內容頁面。

如果這些過濾機制都不適當,內容頁面可以使用過濾機制。在這個情況下,會以一系列的鍵值配對來說明目標物件的屬性。 適用於選項的屬性會隨著類型而不同,且會越過工作台本身的領域,因此, 工作台會將這個層次的過濾委派給實際的選項。

<!ELEMENT extension (page*)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT page (filter* , keywordReference*)>

<!ATTLIST page

id          CDATA #REQUIRED

name        CDATA #REQUIRED

icon        CDATA #IMPLIED

objectClass CDATA #REQUIRED

class       CDATA #REQUIRED

nameFilter  CDATA #IMPLIED

adaptable   (true | false)

category    CDATA #IMPLIED>


<!ELEMENT filter EMPTY>

<!ATTLIST filter

name  CDATA #REQUIRED

value CDATA #REQUIRED>

這個元素是用來計算現行選擇中每個物件的屬性狀態。僅在選項中的每一個物件都具有指定的屬性狀態時,才會進行比對。弓選項中的每一個物件都必須實作或適合於 org.eclipse.ui.IActionFilter



<!ELEMENT keywordReference EMPTY>

<!ATTLIST keywordReference

id CDATA #IMPLIED>

內容頁面對關鍵字的參照。請參閱關鍵字延伸點。



下列是內容頁面定義的範例:

   

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

class 屬性必須指定實作 org.eclipse.ui.IWorkbenchPropertyPage 之類別的完整名稱。

工作台所提供的某些物件可能會有登錄過的內容頁面。 外掛程式可以新增更多這些物件的內容頁面。 內容頁面不限於工作台資源:工作台所顯示的所有物件(甚至是外掛程式所建立的特定網域 private 物件)也可以有內容頁面, 且其他外掛程式可以登錄它們的內容頁面。