Procedimiento para proporcionar un mapa de bits del cuadro de herramientas para un controlHow to: Provide a Toolbox Bitmap for a Control

Si desea tener un icono especial para el control aparezca en el cuadro de herramientas, puede especificar una imagen determinada mediante el ToolboxBitmapAttribute.If you want to have a special icon for your control appear in the Toolbox, you can specify a particular image by using the ToolboxBitmapAttribute. Esta clase es un atributo, un tipo especial de clase que se puede asociar a otras clases.This class is an attribute, a special kind of class you can attach to other classes. Para obtener más información acerca de los atributos, vea información general de atributos (Visual Basic) para Visual Basic o atributos (C#) para C#.For more information about attributes, see Attributes overview (Visual Basic) for Visual Basic or Attributes (C#) for C#.

Mediante el ToolboxBitmapAttribute, puede especificar una cadena que indica la ruta de acceso y nombre de archivo para un mapa de bits de 16 por 16 píxeles.Using the ToolboxBitmapAttribute, you can specify a string that indicates the path and file name for a 16 by 16 pixel bitmap. Este mapa de bits aparecerá junto al control cuando se agregue al cuadro de herramientas.This bitmap then appears next to your control when added to the Toolbox. También puede especificar un Type, en cuyo caso se carga el mapa de bits asociado con ese tipo.You can also specify a Type, in which case the bitmap associated with that type is loaded. Si especifica tanto un Type y 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 Type parámetro.If you specify both a Type and a string, the control searches for an image resource with the name specified by the string parameter in the assembly containing the type specified by the Type parameter.

Para especificar un mapa de bits del cuadro de herramientas para el controlTo specify a Toolbox bitmap for your control

  1. Agregar el ToolboxBitmapAttribute a la declaración de clase del control antes de la Class palabra clave de visual Basic y sobre la declaración de clase de Visual C#.Add the ToolboxBitmapAttribute to the class declaration of your control before the Class keyword for visual Basic, and above the class declaration for 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.Rebuild the project.

    Nota

    El mapa de bits no aparece en el cuadro de herramientas para componentes y controles generados automáticamente.The bitmap does not appear in the Toolbox for autogenerated controls and components. Para ver el mapa de bits, vuelva a cargar el control con el cuadro de diálogo Elegir elementos del cuadro de herramientas.To see the bitmap, reload the control by using the Choose Toolbox Items dialog box. Para obtener más información, vea Tutorial: Rellenar automáticamente el cuadro de herramientas con componentes personalizados.For more information, see Walkthrough: Automatically Populating the Toolbox with Custom Components.

Vea tambiénSee also