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

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

• 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
  {
  }
  

Vea también

Referencia

ToolboxBitmapAttribute

Conceptos

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

Otros recursos

Desarrollar controles de formularios Windows Forms en tiempo de diseño
Atributos de Visual Basic