Esta documentación está archivada y no tiene mantenimiento.

ToolboxBitmapAttribute (Clase)

Actualización: noviembre 2007

Le permite especificar un icono para representar un control en un contenedor, como el Diseñador de formularios de Microsoft Visual Studio.

Espacio de nombres:  System.Drawing
Ensamblado:  System.Drawing (en System.Drawing.dll)

[AttributeUsageAttribute(AttributeTargets.Class)]
public class ToolboxBitmapAttribute : Attribute
/** @attribute AttributeUsageAttribute(AttributeTargets.Class) */
public class ToolboxBitmapAttribute extends Attribute
public class ToolboxBitmapAttribute extends Attribute

Se puede aplicar un objeto ToolboxBitmapAttribute a un control de manera que los contenedores, como el Diseñador de formularios de Microsoft Visual Studio, puedan recuperar un icono que represente el control. El mapa de bits del icono puede encontrarse en un archivo por sí solo o incrustado en el ensamblado que contiene el control. El tamaño del mapa de bits que se incrusta en el ensamblado del control (o que se almacena en un archivo independiente) debe ser de 16 por 16. El método GetImage de un objeto ToolboxBitmapAttribute puede devolver la imagen pequeña de 16 por 16 o una imagen grande de 32 por 32 creada mediante un ajuste de escala de la imagen pequeña.

En el ejemplo de código siguiente se muestra cómo utilizar la clase ToolboxBitmapAttribute para establecer stop.bmp como el icono del Cuadro de herramientas para StopSignControl. En este ejemplo se supone la existencia de un mapa de bits de 16 x 16 píxeles denominado stop.bmp en c:\.

[System.Drawing.ToolboxBitmap("c:\\stop.bmp")]
public class StopSignControl:
    System.Windows.Forms.UserControl

{
    internal System.Windows.Forms.Label Label1;
    internal System.Windows.Forms.Button Button1;

    public StopSignControl() : base()
    {        
        this.Label1 = new System.Windows.Forms.Label();
        this.Button1 = new System.Windows.Forms.Button();

        this.Label1.Font = new System.Drawing.Font("Microsoft Sans Serif", 12.0F, System.Drawing.FontStyle.Regular, System.Drawing.GraphicsUnit.Point, ((byte) 0));

        this.Label1.ForeColor = System.Drawing.Color.Red;
        this.Label1.Location = new System.Drawing.Point(24, 56);
        this.Label1.Name = "Label1";
        this.Label1.TabIndex = 0;
        this.Label1.Text = "Stop!";
        this.Label1.TextAlign = System.Drawing.ContentAlignment.MiddleCenter;

        this.Button1.Enabled = false;
        this.Button1.Location = new System.Drawing.Point(56, 88);
        this.Button1.Name = "Button1";
        this.Button1.Size = new System.Drawing.Size(40, 32);
        this.Button1.TabIndex = 1;
        this.Button1.Text = "stop";

        this.Controls.Add(this.Button1);
        this.Controls.Add(this.Label1);
        this.Name = "StopSignControl";

    }

    private void StopSignControl_MouseEnter(object sender, System.EventArgs e)
    {

        Label1.Text.ToUpper();
        Label1.Font = new System.Drawing.Font(Label1.Font.FontFamily, 14.0F, 
	    System.Drawing.FontStyle.Bold);
        Button1.Enabled = true;
    }

    private void StopSignControl_MouseLeave(object sender, System.EventArgs e)
    {

        Label1.Text.ToLower();
        Label1.Font = new System.Drawing.Font(Label1.Font.FontFamily, 12.0F, 
	    System.Drawing.FontStyle.Regular);
        Button1.Enabled = false;
    }

}


/** @attribute System.Drawing.ToolboxBitmap("c:\\stop.bmp")
 */
public class StopSignControl extends System.Windows.Forms.UserControl
{
    System.Windows.Forms.Label label1;
    System.Windows.Forms.Button button1;

    public StopSignControl()
    {
        this.label1 = new System.Windows.Forms.Label();
        this.button1 = new System.Windows.Forms.Button();

        this.label1.set_Font(new System.Drawing.Font("Microsoft Sans Serif", 
            12, System.Drawing.FontStyle.Regular, 
            System.Drawing.GraphicsUnit.Point, (ubyte)0));

        this.label1.set_ForeColor(System.Drawing.Color.get_Red());
        this.label1.set_Location(new System.Drawing.Point(24, 56));
        this.label1.set_Name("label1");
        this.label1.set_TabIndex(0);
        this.label1.set_Text("Stop!");
        this.label1.set_TextAlign(System.Drawing.ContentAlignment.MiddleCenter);

        this.button1.set_Enabled(false);
        this.button1.set_Location(new System.Drawing.Point(56, 88));
        this.button1.set_Name("button1");
        this.button1.set_Size(new System.Drawing.Size(40, 32));
        this.button1.set_TabIndex(1);
        this.button1.set_Text("stop");

        this.get_Controls().Add(this.button1);
        this.get_Controls().Add(this.label1);
        this.set_Name("StopSignControl");
    } //StopSignControl

    private void StopSignControl_MouseEnter(Object sender, System.EventArgs e)
    {
        label1.set_Text(label1.get_Text().ToUpper());
        label1.set_Font(new Font(label1.get_Font().get_FontFamily(), 14, 
            FontStyle.Bold));
        button1.set_Enabled(true);
    } //StopSignControl_MouseEnter

    private void StopSignControl_MouseLeave(Object sender, System.EventArgs e)
    {
        label1.set_Text(label1.get_Text().ToLower());
        label1.set_Font(new Font(label1.get_Font().get_FontFamily(), 12, 
            System.Drawing.FontStyle.Regular));
        button1.set_Enabled(false);
    } //StopSignControl_MouseLeave
} //StopSignControl


System.Object
  System.Attribute
    System.Drawing.ToolboxBitmapAttribute

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0
Mostrar: