プロパティー・ページ

ID: org.eclipse.ui.propertyPages

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

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

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

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

構成マークアップ:

   <!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 を インプリメントするクラスの完全修飾名を指定する必要があります。

提供される情報: ワークベンチによって提供されているオブジェクトの一部には、 プロパティー・ページが登録されている場合があります。 プラグインにより、これらのオブジェクトにさらにプロパティー・ページを追加することができます。 プロパティー・ページはワークベンチ・リソースに限られません。 ワークベンチ内に表示されるすべてのオブジェクト (プラグインにより作成されたドメイン固有の オブジェクトを含む) は、プロパティー・ページを持つことができ、他のプラグインによりこれらに プロパティー・ページを登録することができます。

Copyright (c) 2002 IBM Corporation and others. All rights reserved. This program and the accompanying materials are made available under the terms of the Common Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/cpl-v10.html