「內容」頁面

識別碼:org.eclipse.ui.propertyPages

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

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

內容頁面會出現在對話框中,當您在物件的蹦現功能表中選取「內容」功能表項目時,通常會見到它。 除了物件類別之外,也可以選用地提供名稱過濾器來登錄特定物件類型 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
     name  CDATA #REQUIRED
     value CDATA #REQUIRED
   >
範例:以下是內容頁面定義的範例:

   <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 的條款來使用