Comment : fournir une bitmap pour un contrôle en vue de l'afficher dans la boîte à outils

Mise à jour : novembre 2007

Si vous souhaitez qu'une icône spéciale pour votre contrôle apparaisse dans la Boîte de dialogue, vous pouvez spécifier une image particulière en utilisant le ToolboxBitmapAttribute. Cette classe est un attribut, c'est-à-dire un type spécial de classe que vous pouvez attacher à d'autres classes. Pour plus d'informations sur les attributs, consultez Vue d'ensemble des attributs dans Visual Basic pour Visual Basic et Attributs (Guide de programmation C#) pour Visual C#.

À l'aide de ToolboxBitmapAttribute, vous pouvez spécifier une chaîne qui indique le chemin d'accès et le nom de fichier d'une bitmap de 16 par 16 pixels. Cette bitmap apparaît alors en regard de votre contrôle lorsqu'elle est ajoutée à la Boîte à outils. Vous pouvez également spécifier une variable Type afin que la bitmap associée à ce type soit chargée. Si vous spécifiez à la fois un Type et une chaîne, le contrôle recherche une ressource d'image avec le nom spécifié par le paramètre de chaîne dans l'assembly contenant le type spécifié par le paramètre Type.

Pour spécifier une bitmap pour votre contrôle en vue de l'afficher dans la boîte à outils

1. Ajoutez ToolboxBitmapAttribute à la déclaration de classe de votre contrôle avant le mot clé Class pour Visual Basic et au-dessus de la déclaration de classe pour 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. Régénérez le projet.

   Remarque :
   La bitmap n'apparaît pas dans la Boîte à outils pour les composants et les contrôles générés automatiquement. Pour afficher la bitmap, rechargez le contrôle à l'aide de la boîte de dialogue Choisir des éléments de boîte à outils. Pour plus d'informations, consultez Procédure pas à pas : remplissage automatique de la boîte à outils avec des composants personnalisés.

Voir aussi

Tâches

Procédure pas à pas : remplissage automatique de la boîte à outils avec des composants personnalisés

Référence

Attributs (Guide de programmation C#)

ToolboxBitmapAttribute

Autres ressources

Développement de contrôles Windows Forms au moment du design

Attributs Visual Basic