Dela via


Anvisningar: Ange en verktygslådas bitmapp för en kontroll

Om du vill att en särskild ikon för kontrollen ska visas i Toolbox- i Visual Studio kan du ange en viss bild med hjälp av ToolboxBitmapAttribute. Den här klassen är ett attribut, en särskild typ av klass som du kan koppla till andra klasser. Mer information om attribut finns i översikten över attribut (Visual Basic) för Visual Basic- eller -attribut (C#) för C#.

Med hjälp av ToolboxBitmapAttributekan du ange en sträng som anger sökvägen och filnamnet för en bitmapp på 16 x 16 bildpunkter. Den här bitmappen visas sedan bredvid kontrollen när den läggs till i Toolbox-. Du kan också ange en Type, i vilket fall bitmappen som är associerad med den typen läses in. Om du anger både en Type och en sträng söker kontrollen efter en bildresurs med det namn som anges av strängparametern i sammansättningen som innehåller den typ som anges av parametern Type.

Så här anger du en verktygslåde-bitmap för din kontroll

  1. Lägg till ToolboxBitmapAttribute i klassdeklarationen för din kontroll före nyckelordet Class för visual Basic och över klassdeklarationen 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. Återskapa projektet.

    Not

    Bitmappen visas inte i verktygslådan för automatiskt genererade kontroller och komponenter. För att se bitmappen, ladda om kontrollen genom att använda dialogrutan Välj verktygslådeobjekt. Mer information finns i Så här gör du: Automatisk ifyllnad i verktygslådan med anpassade komponenter.

Se även