Cómo: Proporcionar un mapa de bits del cuadro de herramientas para un control

Actualización: noviembre 2007

Si desea que un icono especial para el control aparezca en el Cuadro de herramientas, puede especificar una imagen particular utilizando ToolboxBitmapAttribute. Esta clase es un atributo, un tipo de clase especial que se puede asociar a otras clases. Para obtener más información sobre los atributos, vea Información general sobre los atributos de Visual Basic para Visual Basic y Atributos (Guía de programación de C#) para Visual C#.

Mediante ToolboxBitmapAttribute, puede especificar una cadena que indique la ruta de acceso y el nombre de archivo para un mapa de bits de 16 por 16 píxeles. Este mapa de bits aparecerá junto al control cuando se agregue al Cuadro de herramientas. También puede especificar un Type, en cuyo caso se carga el mapa de bits asociado a ese tipo. Si especifica tanto el parámetro Type como una cadena, el control busca un recurso de imagen con el nombre especificado por el parámetro de cadena en el ensamblado que contiene el tipo especificado por el parámetro Type.

Para especificar un mapa de bits de cuadro de herramientas a un control

1. Agregue ToolboxBitmapAttribute a la declaración de clase del control antes de la palabra clave Class para Visual Basic, y sobre la declaración de clase para 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. Vuelva a generar el proyecto.

   Nota:
   El mapa de bits no aparece en el cuadro de herramientas para los controles y componentes generados automáticamente. Para ver el mapa de bits, recargue el control mediante el cuadro de diálogo Elegir elementos del cuadro de herramientas. Para obtener más información, vea Tutorial: Rellenar automáticamente el cuadro de herramientas con componentes personalizados.

Vea también

Tareas

Tutorial: Rellenar automáticamente el cuadro de herramientas con componentes personalizados

Referencia

Atributos (Guía de programación de C#)

ToolboxBitmapAttribute

Otros recursos

Desarrollar controles de formularios Windows Forms en tiempo de diseño

Atributos de Visual Basic