プロパティー・ページ

ID: org.eclipse.ui.propertyPages

説明 : この拡張ポイントは、 あるタイプのオブジェクト用に、オブジェクトのプロパティー・ページを追加するために使用します。 定義されたこれらのプロパティー・ページは、そのタイプのオブジェクトのプロパティー・ダイアログ内に表示されます。

プロパティー・ページを使用することにより、 ユーザーは分かりやすい形式で、オブジェクトのプロパティーを操作することができます。 オブジェクトのプロパティーの編集に使用可能なスペースが制限されるプロパティー・ビューとは異なり、 プロパティー・ページでは、ラベル、アイコンなどに対し、より広い範囲でかつ複雑なコントロールを定義することが可能になります。 論理的にまとめられたプロパティーは、プロパティー・シート内で分散させずに、ページ内でクラスター化することもできます。 ただし、ほとんどのアプリケーションでは、 オブジェクトのプロパティーをプロパティー・シートとプロパティー・ページの両方を使用して管理することが一般的です。

プロパティー・ページは、オブジェクトのポップアップ・メニューから 「プロパティー (Properties menu)」メニュー項目を選択して表示されるダイアログ・ボックス内に表示されます。 オブジェクト・クラスの他に、特定のオブジェクト・タイプについてのみプロパティー・ページを登録するために、 名前フィルターもオプションで提供することができます。

これらのフィルター・メカニズムが不適切な場合、 プロパティー・ページは filter メカニズムを使用することができます。 この場合、ターゲット・オブジェクトの属性は、一連のキー値のペアに記述されます。 選択に対し適用される属性は、選択タイプに固有であり、ワークベンチのドメインの範囲外であるため、 ワークベンチは、実際の選択に対して、このレベルにおけるフィルター操作を代行します。

構成マークアップ:

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