特性页面

标识符:org.eclipse.ui.propertyPages

描述此扩展点用来为给定类型的对象添加附加特性页面。一旦定义了这些特性页面,它们就会出现在该类型的对象的“特性对话框”中。

特性页面是用户与对象的特性交互作用的友好方法。与“特性”视图(它限制可用于编辑对象特性的空间)不同, 特性页面的有利之处在于具有使用标号、图标等来定义更大、更复杂控件的自由。还可将逻辑上为一致的各特性群集在一个页面中,而不是分散在特性表中。然而,在大多数应用程序中,通过特性表公开对象的某些特性而通过特性页面公开另一些特性是很恰当的。

特性页面显示在当在对象的弹出菜单上选择“特性”菜单项时通常可见的对话框中。除对象类之外,还可选择提供名称过滤器来仅注册特定对象类型的特性页面。

如果这些过滤机制不足够,则特性页面可使用过滤器机制。在这种情况下,将在一系列键值对中描述目标对象的属性。应用在选择上的属性是特定于类型的,且超出了工作台本身的域,因此工作台将代理在此级别上过滤为实际选择的操作。

配置标记:

   <!ELEMENT page (filter)*>
   <!ATTLIST page
      id           CDATA #REQUIRED
      name         CDATA #REQUIRED
      icon         CDATA #IMPLIED
      objectClass  CDATA #REQUIRED
      class        CDATA #REQUIRED
      nameFilter   CDATA #IMPLIED
   >

   <!ELEMENT filter EMPTY>
   <!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 的类的全限定名。

提供的实现工作台提供的某些对象可能注册了特性页面。允许插件为这些对象添加更多特性页面。特性页面并不限于工作台资源:显示在工作台中的所有对象(甚至插件创建的域特定对象)可能具有特性页面,且允许其他插件注册它们的特性页面。

Copyright IBM Corp. 2000, 2001.  All Rights Reserved.