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

Aggiornamento: novembre 2007

Per visualizzare un'icona speciale per il controllo nella Casella degli strumenti, è possibile specificare una particolare immagine utilizzando ToolboxBitmapAttribute. Questa classe è un attributo, ovvero un particolare tipo di classe che è possibile collegare ad altre classi. Per ulteriori informazioni sugli attributi, vedere Cenni preliminari sugli attributi in Visual Basic per Visual Basic e Attributi (Guida per programmatori C#) per Visual C#.

La classe ToolboxBitmapAttribute consente di specificare una stringa che indica il nome file e il percorso di una bitmap di 16 x 16 pixel. La bitmap verrà quindi visualizzata accanto al controllo quando quest'ultimo viene aggiunto alla Casella degli strumenti. È inoltre possibile specificare un parametro Type in modo da caricare la bitmap associata al tipo specificato. Se si specifica sia un parametro Type che una stringa, il controllo ricercherà una risorsa immagine il cui nome è specificato dal parametro stringa nell'assembly contenente il tipo specificato dal parametro Type.

Per specificare una bitmap nella Casella degli strumenti per il controllo

1. Aggiungere ToolboxBitmapAttribute alla dichiarazione di classi del controllo prima della parola chiave Class per Visual Basic e sopra la dichiarazione di classi 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
   {
   }
   

   // 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. Rigenerare il progetto.

   Nota:
   La bitmap non è visualizzata nella casella degli strumenti per controlli e componenti generati automaticamente. Per vedere la bitmap, ricaricare il controllo utilizzando la finestra di dialogo Scegli elementi della Casella degli strumenti. Per ulteriori informazioni, vedere Procedura dettagliata: compilare automaticamente la casella degli strumenti con componenti personalizzati.

Vedere anche

Attività

Procedura dettagliata: compilare automaticamente la casella degli strumenti con componenti personalizzati

Riferimenti

Attributi (Guida per programmatori C#)

ToolboxBitmapAttribute

Altre risorse

Sviluppo di controlli Windows Form in fase di progettazione

Attributi di Visual Basic