Gewusst wie: Bereitstellen einer Toolboxbitmap für ein Steuerelement

Aktualisiert: November 2007

Wenn in der Toolbox ein spezielles Symbol für das Steuerelement angezeigt werden soll, können Sie mithilfe des ToolboxBitmapAttribute ein Bild festlegen. Diese Klasse ist ein Attribut, d. h. eine besondere Art von Klasse, die an andere Klassen angefügt werden kann. Weitere Informationen über Attribute finden Sie unter Übersicht über Attribute in Visual Basic für Visual Basic und Attribute (C#-Programmierhandbuch) für Visual C#.

Mithilfe von ToolboxBitmapAttribute können Sie eine Zeichenfolge angeben, die den Pfad und den Dateinamen für eine Bitmap von 16 x 16 Pixel angibt. Diese Bitmap wird, nachdem sie der Toolbox hinzugefügt wurde, neben dem Steuerelement angezeigt. Sie können auch einen Type angeben, sodass die diesem Typ zugeordnete Bitmap geladen wird. Wenn Sie sowohl Type als auch eine Zeichenfolge angeben, sucht das Steuerelement in der Assembly, die den vom Type-Parameter angegebenen Typ enthält, nach einer Bildressource mit dem vom Zeichenfolgenparameter angegebenen Namen.

So geben Sie eine Toolboxbitmap für das Steuerelement an

  1. Fügen Sie der Klassendeklaration des Steuerelements vor dem Schlüsselwort Class für Visual Basic und oberhalb der Klassendeklaration für Visual C# das ToolboxBitmapAttribute 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
    {
    }
    
    // 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
    {
    }
    
  2. Erstellen Sie das Projekt neu.

    Hinweis:

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

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Automatisches Füllen der Toolbox mit benutzerdefinierten Komponenten

Referenz

Attribute (C#-Programmierhandbuch)

ToolboxBitmapAttribute

Weitere Ressourcen

Entwickeln von Windows Forms-Steuerelementen zur Entwurfszeit

Visual Basic-Attribute