Partager via

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

  • Article

Si vous souhaitez avoir une icône spéciale pour votre contrôle apparaissent dans la boîte à outils de Visual Studio, vous pouvez spécifier une image particulière à l’aide de l’élément ToolboxBitmapAttribute. Cette classe est un attribut, c’est-à-dire un type spécial de classe que vous pouvez joindre à d’autres classes. Pour plus d’informations sur les attributs, consultez Vue d’ensemble des attributs (Visual Basic) pour Visual Basic ou Attributs (C#) pour C#.

À l’aide du ToolboxBitmapAttributefichier , vous pouvez spécifier une chaîne qui indique le chemin d’accès et le nom de fichier d’une bitmap de 16 à 16 pixels. Cette image bitmap apparaît alors en regard de votre contrôle lorsqu’elle est ajoutée à la boîte à outils. Vous pouvez également spécifier un Type, auquel cas la bitmap associée à ce type est chargée. Si vous spécifiez à la fois une chaîne et une Type 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 Type paramètre.

Pour spécifier une image de bitmap dans la boîte à outils concernant votre contrôle

  1. Ajoutez la ToolboxBitmapAttribute déclaration de classe de votre contrôle avant le Class mot clé 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
{
}

  2. Regénérez le projet.

    Remarque

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

Voir aussi