Vorgehensweise: Bereitstellen einer Toolboxbitmap für ein Steuerelement

  • Artikel

Wenn Sie möchten, dass ein besonderes Symbol für Ihr Steuerelement in der Toolbox von Visual Studio angezeigt wird, können Sie mithilfe von ToolboxBitmapAttribute ein bestimmtes Bild angeben. Diese Klasse ist ein Attribut, eine besondere Klassenform, die Sie an andere Klassen anfügen können. Weitere Informationen zu Attributen finden Sie in der Attributübersicht (Visual Basic) für Visual Basic oder unter Attribute (C#) für C#.

Mit ToolboxBitmapAttribute können Sie eine Zeichenfolge angeben, die den Pfad und Dateinamen für eine 16 x 16-Pixel-Bitmap angibt. Diese Bitmap wird dann neben dem Steuerelement angezeigt, wenn sie zur Toolbox hinzugefügt wird. Sie können auch Type angeben. In diesem Fall wird die Bitmap geladen, die diesem Typ zugeordnet ist. Wenn Sie Type und eine Zeichenfolge angeben, sucht das Steuerelement nach einer Bildressource. Die Bildressource hat den Namen, der durch den Zeichenfolgenparameter in der Assembly angegeben wurde, die den Typ enthält, der durch den Parameter Type angegeben wird.

So geben sie eine Toolboxbitmap für Ihr Steuerelement an

  1. Fügen Sie ToolboxBitmapAttribute zur Klassendeklaration Ihres Steuerelements hinzu (vor dem Schlüsselwort Class für Visual Basic bzw. über der Klassendeklaration für 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. Erstellen Sie das Projekt neu.

    Hinweis

    Die Bitmap wird nicht in der Toolbox für automatisch generierte Steuerelemente und Komponenten angezeigt. Laden Sie das Steuerelement mithilfe des Dialogfelds Toolboxelemente auswählen neu, um die Bitmap anzuzeigen. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Automatisches Füllen der Toolbox mit benutzerdefinierten Komponenten.

Weitere Informationen