ツールボックス アイコン

Visual Studio および Expression Blend で、カスタムの WPF コントロールおよび Silverlight コントロールと共にツールボックス アイコンを含めることができます。 このトピックでは、ツールボックス アイコンの名前を付ける方法とそれらのアイコンを埋め込みリソースとして含める方法について説明します。

サポートされるファイルの種類

WPF Designer for Visual Studio でツールボックス アイコンとしてサポートされるファイルの種類を次の一覧に示します。 

  • BMP

  • GIF

  • JPG

  • JPEG

  • PNG

注意

Expression Blend では、.png ファイルのみをサポートしています。

名前付け規約

ツールボックス アイコンとカスタム コントロールを関連付けるには、次の名前付け規則を使用します。 デザイン ツールは、コントロールのアセンブリ内の埋め込みリソースを調べて、適切な名前の付けられたイメージ ファイルを探します。

最も単純な方法では、コントロールのプロジェクトに埋め込みリソースとしてツールボックス アイコンのイメージを追加します。 そのファイルに ControlName.Extension という名前付け、[プロパティ] ウィンドウでその [ビルド アクション][埋め込みリソース] に設定します。 WPF デザイナーは、コントロールの型名と一致するファイル名を持つリソースを検索します。 詳細については、「チュートリアル : コントロール用のカスタム ツールボックス アイコンの作成」を参照してください。

注意

下位互換性を維持するために、Visual Studio 2010 では、Visual Studio 2008 によって使用される名前付け規則をサポートしています。 詳細については、「Visual Studio 2008 のツールボックス アイコン」を参照してください。

Visual Studio 2010 では、ツールボックス アイコンについて次の名前付け規則をサポートしています。 角かっこ ([]) で囲まれている部分文字列は省略可能です。

[AnyString]Namespace.ControlName[.Product][.AnyString].Extension

デザイナーでツールボックス アイコンを検索するときには、Namespace、ControlName、および Product の各部分文字列と一致するものが検索されます。 If Namespace および ControlName がコントロールと一致しない場合、アイコンはツールボックスに表示されません。

デザイナーでは、Product 部分文字列を使用して、他の製品のアイコンを除外できます。 たとえば、Visual Studio では、Product が "VisualStudio" に設定されているアイコンが選択されます。

Visual Studio および Expression Blend のアイコンに使用できるツールボックスのアイコンの名前付け規則の例を次の一覧に示します。

  • Namespace.ControlName.VisualStudio.Extension

  • Namespace.ControlName.VisualStudio.AnyString.Extension

  • Namespace.ControlName.Expression.png

  • Namespace.ControlName.Expression.AnyString.png

これらの名前に一致するアイコンが見つからない場合には、次の名前が検索されます。

  • Namespace.ControlName.Extension

  • Namespace.ControlName.AnyString.Extension

TailspinToysControlLibrary 名前空間にある TailspinToysControl という名前のコントロールのツールボックス アイコン名の例を次の一覧に示します。 イメージ形式に関する追加オプション情報が追加されていますが、デザイナーでは使用されません。

  • TailspinToysControlLibrary.TailspinToysControl.VisualStudio.24bit.48x48.bmp

  • TailspinToysControlLibrary.TailspinToysControl.Expression.4bit.16x16.png

デザイナーでツールボックス アイコンが見つかると、デザイナーの対象アイコンのサイズに最も近いアイコンが表示用に読み込まれます。 一致基準を適用する順序を次の一覧に示します。

  1. アイコン名にデザイナーが指定されていないアイコンではなく、デザイナーが指定されているアイコンを選択します。 たとえば、WPF デザイナーでは、アイコン名が "Expression" ではなく、"VisualStudio" という名前のアイコンが選択されます。

  2. レンダリング サイズに最も近いアイコンを選択します。 Visual Studio ツールボックスでは、16x16 ピクセルに最も近いアイコンが読み込まれ、そのアイコンが 24 ビットの色深度にマップされます。

  3. 最初に見つかったアイコンを選択します。

既定のツールボックスアイコンのオーバーライド

WPF デザイナーの機能拡張フレームワークを使用して、コントロールの実行時アセンブリに埋め込まれているツールボックス アイコンをオーバーライドできます。 詳細については、「チュートリアル: ツールボックス アイコンへのメタデータの提供」を参照してください。

参照

概念

Visual Studio 2008 のツールボックス アイコン

その他の技術情報

チュートリアル: ツールボックス アイコンへのメタデータの提供