Procedimiento para proporcionar un mapa de bits del cuadro de herramientas para un control

  • Artículo

Si desea que aparezca un icono especial para el control en el cuadro de herramientas de Visual Studio, puede especificar una imagen determinada mediante ToolboxBitmapAttribute. Esta clase es un atributo, un tipo especial de clase que se puede asociar a otras clases. Para obtener más información sobre los atributos, vea Información general sobre los atributos (Visual Basic) si usa Visual Basic o Atributos (C#) si usa C#.

Mediante ToolboxBitmapAttribute, puede especificar una cadena que indica la ruta de acceso y el nombre de archivo de un mapa de bits de 16 x 16 píxeles. Este mapa de bits aparecerá junto al control cuando se agregue al cuadro de herramientas. También puede especificar un tipo Type, en cuyo caso el mapa de bits se carga en asociación con ese tipo. Si se especifica tanto 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 del cuadro de herramientas para el control

  1. Agregue el objeto ToolboxBitmapAttribute a la declaración de clase del control antes de la palabra clave Class en Visual Basic y encima de la declaración de clase en 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. Recompile el proyecto.

    Nota:

    El mapa de bits no aparece en el cuadro de herramientas para componentes y controles generados automáticamente. Para ver el mapa de bits, vuelva a cargar el control con 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.

Consulte también