Share via

Procedura: specificare una bitmap nella casella degli strumenti per un controllo

  • Articolo

Se si vuole visualizzare un'icona speciale per il controllo nella casella degli strumenti di Visual Studio, è possibile specificare una particolare immagine usando .ToolboxBitmapAttribute Questa classe è un attributo, un tipo speciale di classe che è possibile allegare ad altre classi. Per altre informazioni sugli attributi, vedere Panoramica degli attributi (Visual Basic) per Visual Basic o Attributi (C#) per C#.

ToolboxBitmapAttributeUsando , è possibile specificare una stringa che indica il percorso e il nome del file per una bitmap da 16 a 16 pixel. Questa bitmap viene quindi visualizzata accanto al controllo quando è aggiunta alla Casella degli strumenti. È anche possibile specificare un oggetto Type, nel qual caso viene caricata la bitmap associata a tale tipo. Se si specifica sia una stringa che una Type stringa, il controllo cerca una risorsa immagine con il nome specificato dal parametro stringa nell'assembly contenente il tipo specificato dal Type parametro .

Per specificare una bitmap della casella degli strumenti per il controllo

  1. ToolboxBitmapAttribute Aggiungere alla dichiarazione di classe del controllo prima della Class parola chiave per visual Basic e sopra la dichiarazione di classe per 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. Ricompilare il progetto.

    Nota

    La bitmap non viene visualizzata nella casella degli strumenti per i controlli e i componenti generati automaticamente. Per visualizzare la bitmap, ricaricare il controllo usando la finestra di dialogo Scegli elementi della casella degli strumenti. Per altre informazioni, vedere Procedura dettagliata: Compilare automaticamente la casella degli strumenti con componenti personalizzati.

Vedi anche