Partager via

Guide pratique pour fournir une bitmap de boîte à outils pour un contrôle

  • 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 la ToolboxBitmapAttribute. Cette classe est un attribut , 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 (Visual Basic) pour Visual Basic ou Attributs (C#) pour C#.

À l’aide de la 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 à 16 pixels. Cette bitmap apparaît ensuite 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 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 de boîte à outils pour votre contrôle

  1. Ajoutez la 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
{
}

  2. Régénérez le projet.

    Note

    La bitmap n’apparaît pas dans la boîte à outils pour les contrôles et composants générés automatiquement. Pour afficher la bitmap, rechargez le contrôle en utilisant la boîte de dialogue Choisir des éléments dans la 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