ThumbnailAttribute クラス

2011-08-09

Visual Studio または Expression Blend のツールボックスで、アイコンをカスタムの Windows Presentation Foundation (WPF) コントロールまたは Silverlight コントロールと関連付けます。

継承階層

System.Object
System.Attribute
Microsoft.Windows.Design.ThumbnailAttribute

名前空間: Microsoft.Windows.Design
アセンブリ: Microsoft.Windows.Design.Interaction (Microsoft.Windows.Design.Interaction.dll 内)

構文

'宣言
<AttributeUsageAttribute(AttributeTargets.Class, AllowMultiple := True)> _
Public NotInheritable Class ThumbnailAttribute _
    Inherits Attribute

[AttributeUsageAttribute(AttributeTargets.Class, AllowMultiple = true)]
public sealed class ThumbnailAttribute : Attribute

[AttributeUsageAttribute(AttributeTargets::Class, AllowMultiple = true)]
public ref class ThumbnailAttribute sealed : public Attribute

[<Sealed>]
[<AttributeUsageAttribute(AttributeTargets.Class, AllowMultiple = true)>]
type ThumbnailAttribute =  
    class
        inherit Attribute
    end

public final class ThumbnailAttribute extends Attribute

ThumbnailAttribute 型で公開されるメンバーは以下のとおりです。

コンストラクター

	名前	説明
	ThumbnailAttribute	ThumbnailAttribute クラスの新しいインスタンスを初期化します。

このページのトップへ

プロパティ

	名前	説明
	ResourceAssembly	アイコンイメージを格納するアセンブリを取得します。
	ResourceName	アイコンイメージの名前を取得します。
	TypeId	派生クラスに実装されている場合は、この Attribute の一意の識別子を取得します。 (Attribute から継承されます。)

このページのトップへ

メソッド

	名前	説明
	Equals	インフラストラクチャ。このインスタンスが、指定したオブジェクトに等しいかどうかを示す値を返します。 (Attribute から継承されます。)
	Finalize	オブジェクトがガベージコレクションにより収集される前に、そのオブジェクトがリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	GetHashCode	対象のインスタンスのハッシュコードを返します。 (Attribute から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	IsDefaultAttribute	派生クラス内でオーバーライドされたときに、このインスタンスの値が派生クラスの既定値かどうかを示します。 (Attribute から継承されます。)
	Match	派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 (Attribute から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	ToString	現在のオブジェクトを表す文字列を返します。 (Object から継承されます。)

このページのトップへ

明示的インターフェイスの実装

	名前	説明
	_Attribute.GetIDsOfNames	名前のセットを対応するディスパッチ識別子のセットにマッピングします。 (Attribute から継承されます。)
	_Attribute.GetTypeInfo	オブジェクトの型情報を取得します。この情報はインターフェイスの型情報の取得に使用できます。 (Attribute から継承されます。)
	_Attribute.GetTypeInfoCount	オブジェクトが提供する型情報インターフェイスの数 (0 または 1) を取得します。 (Attribute から継承されます。)
	_Attribute.Invoke	オブジェクトによって公開されたプロパティおよびメソッドへのアクセスを提供します。 (Attribute から継承されます。)

このページのトップへ

解説

ThumbnailAttribute を適用して、ツールボックスアイコンをカスタムの WPF コントロールまたは Silverlight コントロールに割り当てます。

コントロールを表すアイコンを型に追加する手順を次に示します。

カスタムコントロール用に、デザイン時メタデータアセンブリを作成します。詳細については、「チュートリアル: カスタムのデザイン時メタデータの提供」を参照してください。
ThumbnailAttribute に渡す型と同じフォルダー階層にイメージを追加します。サポートされるファイルの種類は BMP、GIF、JPG、JPEG、および PNG です。

デザイナーホストに応じて、ツールボックスアイコンに使用されるイメージサイズが異なります。ホスト固有のメタデータアセンブリ *.VisualStudio.Design.dll および *.Expression.Design.dll で ThumbnailAttribute を指定することによって、WPF デザイナーと Expression Blend 用に異なるイメージを指定できます。

Expression Blend は、大きいアイコンサイズに 24 × 24、小さいアイコンサイズに 12 × 12 を使用します。 WPF デザイナーは 16 × 16 を使用します。詳細については、「ツールボックスアイコン」を参照してください。
[プロパティ] ウィンドウで、イメージのビルドアクションを [埋め込まれたリソース] に設定します。

注意

プロジェクトのサブフォルダーは、埋め込みリソースが存在する名前空間に影響します。
IProvideAttributeTable インターフェイスを実装して、ThumbnailAttribute をコントロールのクラスに追加します。同じ ThumbnailAttribute を複数のコントロールに適用することによって、同じイメージを複数の型に再利用できます。

ThumbnailAttribute は、コレクションエディターまたはサブプロパティエディターの "新しいインスタンス" 機能に追加した型の既定のアイコンを探すのにも使用されます。