方法 : コントロールにツールボックス ビットマップを指定する

更新 : 2007 年 11 月

コントロールの特殊なアイコンをツールボックスに表示させる場合は、ToolboxBitmapAttribute を使用して特定のイメージを指定します。このクラスは属性であり、他のクラスに追加できる特殊なクラスです。属性の詳細については、Visual Basic の場合は「Visual Basic における属性」、Visual C# の場合は「属性 (C# プログラミング ガイド)」を参照してください。

ToolboxBitmapAttribute を使用すると、16 x 16 ピクセルのビットマップのパスとファイル名を示す文字列を指定できます。コントロールをツールボックスに追加すると、このビットマップがコントロールの横に表示されます。また、Type を指定して、特定の種類に関連付けられたビットマップを読み込むようにすることもできます。Type と文字列の両方を指定すると、コントロールは、Type パラメータで指定された種類のイメージが含まれるアセンブリから、文字列パラメータで指定された名前のイメージ リソースを検索します。

コントロールにツールボックス ビットマップを指定するには

1. コントロールのクラス宣言に ToolboxBitmapAttribute を追加します。Visual Basic の場合は Class キーワードの前に、Visual C# の場合はクラス宣言の上に追加します。

   ' Specifies the bitmap associated with the Button type.
   <ToolboxBitmap(GetType(Button))> Class MyControl1
   ' Specifies a bitmap file.
   End Class
   <ToolboxBitmap("C:\Documents and Settings\Joe\MyPics\myImage.bmp")> _
      Class MyControl2
   End Class
   ' Specifies a type that indicates the assembly to search, and the name 
   ' of an image resource to look for.
   <ToolboxBitmap(GetType(MyControl), "MyControlBitmap")> Class MyControl
   End Class
   

   // Specifies the bitmap associated with the Button type.
   [ToolboxBitmap(typeof(Button))]
   class MyControl1 : UserControl
   {
   }
   // Specifies a bitmap file.
   [ToolboxBitmap(@"C:\Documents and Settings\Joe\MyPics\myImage.bmp")]
   class MyControl2 : UserControl
   {
   }
   // Specifies a type that indicates the assembly to search, and the name 
   // of an image resource to look for.
   [ToolboxBitmap(typeof(MyControl), "MyControlBitmap")]
   class MyControl : UserControl
   {
   }
   

   // Specifies the bitmap associated with the Button type.
   /** @attribute ToolboxBitmap(Button.class)  */
   class MyControl1 extends UserControl
   {
   }
   // Specifies a bitmap file.
   /** @attribute ToolboxBitmap("C:\\Documents and Settings\\Joe\\MyPics\\myImage.bmp")*/
   class MyControl2 extends UserControl
   {
   }
   // Specifies a type that indicates the assembly to search, and the name 
   // of an image resource to look for.
   /* @attribute ToolboxBitmap(MyControl.class, "MyControlBitmap") */
   class MyControl extends UserControl
   {
   }
   

2. プロジェクトを再ビルドします。

   メモ :
   自動的に生成されたコントロールとコンポーネントのビットマップがツールボックスに表示されません。ビットマップを表示するには、[ツールボックス アイテムの選択] ダイアログ ボックスを使用してコントロールを再読み込みします。詳細については、「チュートリアル : ツールボックスへのカスタム コンポーネントの自動設定」を参照してください。

参照

処理手順

チュートリアル : ツールボックスへのカスタム コンポーネントの自動設定

参照

属性 (C# プログラミング ガイド)

ToolboxBitmapAttribute

その他の技術情報

デザイン時の Windows フォーム コントロールの開発

Visual Basic の属性