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

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

• 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
  {
  }
  

Voir aussi

Référence

ToolboxBitmapAttribute

Concepts

Attributs (Guide de programmation C#)

Autres ressources

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