プロパティー・ページ

ID: org.eclipse.ui.propertyPages

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

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

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

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

構成マークアップ:

   <!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)  #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 Corporation and others 2000, 2002.