Freigeben über

Vorgehensweise: Bereitstellen einer Werkzeugkasten-Bitmap für ein Steuerelement

  • Artikel

Wenn ein spezielles Symbol für Ihr Steuerelement in der Toolbox von Visual Studio angezeigt werden soll, können Sie ein bestimmtes Bild mithilfe von ToolboxBitmapAttributeangeben. Diese Klasse ist ein Attribut, eine spezielle Art von Klasse, die Sie mit anderen Klassen verknüpfen können. Weitere Informationen zu Attributen finden Sie unter Attributes overview (Visual Basic) for Visual Basic or Attributes (C#) for C#.

Mithilfe der ToolboxBitmapAttributekönnen Sie eine Zeichenfolge angeben, die den Pfad und Dateinamen für eine Bitmap mit 16 x 16 Pixel angibt. Diese Bitmap wird dann neben Ihrem Steuerelement angezeigt, wenn sie der Toolboxhinzugefügt wird. Sie können auch eine Typeangeben, in diesem Fall wird die diesem Typ zugeordnete Bitmap geladen. Wenn Sie sowohl eine Type als auch eine Zeichenfolge angeben, sucht das Steuerelement nach einer Bildressource mit dem Namen, der durch den Zeichenfolge-Parameter angegeben wird, in der Assembly, die den Typ enthält, der vom Parameter Type angegeben wird.

So geben Sie eine Toolbox-Bitmap für Ihr Steuerelement an

  1. Fügen Sie die ToolboxBitmapAttribute der Klassendeklaration Ihres Steuerelements vor dem Schlüsselwort Class für Visual Basic und oberhalb der Klassendeklaration für Visual C# hinzu.

    ' 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. Erstellen Sie das Projekt neu.

    Anmerkung

    Die Bitmap wird nicht in der Toolbox für automatisch generierte Steuerelemente und Komponenten angezeigt. Um die Bitmap anzuzeigen, laden Sie das Steuerelement neu, indem Sie das Dialogfeld Toolboxelemente auswählen. Weitere Informationen finden Sie unter: Exemplarische Vorgehensweise : Automatisches Auffüllen der Toolbox mit benutzerdefinierten Komponenten.

Siehe auch