ご使用のプラグインは、デコレーターを使用して、 ワークベンチ・ビューに表示されるリソースおよび他のオブジェクトのイメージに注釈を付けることができます。 デコレーターは、プラグインが既存のリソース・タイプのために機能性を追加するときに役立ちます。 標準のワークベンチ・ビューの多くは、デコレーションの表示に関係します。
たとえば、PDE には、ユーザーがバイナリーおよびソース・プロジェクトを識別できるデコレーターが組み込まれます。
com.example.sourceProject プロジェクトは、ナビゲーターに表示される唯一のソース・プロジェクトです。 すべての他のバイナリー・プロジェクトが、バイナリー・デコレーターをプロジェクト・アイコンの左上に表示する方法に注意してください。 このデコレーターは、org.eclipse.ui.decorators 拡張ポイントを使用して、PDE によって組み込まれます。
<extension point="org.eclipse.ui.decorators"> <decorator objectClass="org.eclipse.core.resources.IResource" adaptable="true" label="%decorator.label" state="false" class="org.eclipse.pde.internal.ui.wizards.imports.BinaryProjectDecorator" id="org.eclipse.pde.ui.binaryProjectDecorator"> <description> %decorator.desc </description> </decorator> </extension>
class 属性は、 ILabelDecorator をインプリメントするクラスに名前を付けます。 このクラスを使用すると、ユーザーが独自の注釈を使用してオリジナル・ ラベルのイメージおよびテキストを装飾することができます。 label および description 属性は、設定ダイアログ内のデコレーターの命名および説明に使用されるテキストを指定します。 objectClass は、デコレーターが適用される必要のあるオブジェクトのクラスに名前を付けます。 adaptable フラグは、クラスに適用するオブジェクトも装飾する必要があるかどうかを指示します。 state フラグは、デコレーターをデフォルトで可視にするかどうか制御します。
デコレーターは、最終的にワークベンチの「ラベル装飾」設定ページを介して、ユーザーによって制御されます。 デコレーターは、個々にオンおよびオフにできます。 たとえそうだとしても、既存のプラットフォーム SDK デコレーターとオーバーラップまたは競合しないようにするのは、デコレーターを設計することはいい考えです。 計算するには高額な、または娯楽を含んでいる可能性のある情報が、ご使用のデコレーターに含まれる場合、 デコレーターがオンになったらユーザーがさらに微調整できる、独自の設定を組み込みたい場合があります。 この技法は、CVS クライアントによって使用されます。