ToolboxBitmapAttribute ToolboxBitmapAttribute ToolboxBitmapAttribute ToolboxBitmapAttribute Class

Definición

Le permite especificar un icono para representar un control en un contenedor, como el Diseñador de formularios de Microsoft Visual Studio.Allows you to specify an icon to represent a control in a container, such as the Microsoft Visual Studio Form Designer.

public ref class ToolboxBitmapAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.Class)]
public class ToolboxBitmapAttribute : Attribute
type ToolboxBitmapAttribute = class
    inherit Attribute
Public Class ToolboxBitmapAttribute
Inherits Attribute
Herencia
ToolboxBitmapAttributeToolboxBitmapAttributeToolboxBitmapAttributeToolboxBitmapAttribute
Atributos

Ejemplos

En el ejemplo de código siguiente se muestra cómo ToolboxBitmapAttribute usar la clase stop.bmp para establecer como StopSignControlel icono del cuadro de herramientas para.The following code example demonstrates how to use the ToolboxBitmapAttribute class to set stop.bmp as the toolbox icon for the StopSignControl. En este ejemplo se da por supuesto que existe un mapa de bits de 16 por stop.bmp 16 píxeles denominado\en c:.This example assumes the existence of a 16-by-16-pixel bitmap named stop.bmp at c:\.

[ToolboxBitmap("c:\\stop.bmp")]
public ref class StopSignControl:
    public System::Windows::Forms::UserControl
{
private:
    Label^ label1;
private:
    Button^ button1;

public:
    StopSignControl() : UserControl()
    {
        this->label1 = gcnew System::Windows::Forms::Label();
        this->button1 = gcnew System::Windows::Forms::Button();

        this->label1->Font = gcnew 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 = 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 = System::Drawing::Point(56, 88);
        this->button1->Name = "Button1";
        this->button1->Size = 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";

        this->MouseEnter +=
            gcnew EventHandler(this, 
                &StopSignControl::StopSignControl_MouseEnter);
        this->MouseLeave +=
            gcnew EventHandler(this, 
                &StopSignControl::StopSignControl_MouseLeave);

    }

private:
    void StopSignControl_MouseEnter(Object^ sender,
        EventArgs^ e)
    {

        label1->Text = label1->Text->ToUpper();
        label1->Font = gcnew System::Drawing::Font(label1->Font->FontFamily,
            14.0F, FontStyle::Bold);
        button1->Enabled = true;
    }

private:
    void StopSignControl_MouseLeave(Object^ sender,
        EventArgs^ e)
    {

        label1->Text = label1->Text->ToLower();
        label1->Font = gcnew System::Drawing::Font(label1->Font->FontFamily,
            12.0F, FontStyle::Regular);
        button1->Enabled = false;
    }

};
[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;
    }

}
<System.Drawing.ToolboxBitmap("c:\stop.bmp")> _
Public Class StopSignControl
    Inherits System.Windows.Forms.UserControl

    Friend WithEvents Label1 As System.Windows.Forms.Label
    Friend WithEvents Button1 As System.Windows.Forms.Button

    Public Sub New()
        MyBase.New()
        Me.Label1 = New System.Windows.Forms.Label
        Me.Button1 = New System.Windows.Forms.Button

        Me.Label1.Font = New System.Drawing.Font("Microsoft Sans Serif", _
            12.0F, System.Drawing.FontStyle.Regular, _
            System.Drawing.GraphicsUnit.Point, CType(0, Byte))

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

        Me.Button1.Enabled = False
        Me.Button1.Location = New System.Drawing.Point(56, 88)
        Me.Button1.Name = "Button1"
        Me.Button1.Size = New System.Drawing.Size(40, 32)
        Me.Button1.TabIndex = 1
        Me.Button1.Text = "stop"

        Me.Controls.Add(Me.Button1)
        Me.Controls.Add(Me.Label1)
        Me.Name = "StopSignControl"

    End Sub

    Private Sub StopSignControl_MouseEnter(ByVal sender As Object, _
        ByVal e As System.EventArgs) Handles MyBase.MouseEnter

        Label1.Text.ToUpper()
        Label1.Font = New System.Drawing.Font(Label1.Font.FontFamily, _
            14.0F, System.Drawing.FontStyle.Bold)
        Button1.Enabled = True
    End Sub

    Private Sub StopSignControl_MouseLeave(ByVal sender As Object, _
        ByVal e As System.EventArgs) Handles MyBase.MouseLeave

        Label1.Text.ToLower()
        Label1.Font = New System.Drawing.Font(Label1.Font.FontFamily, 12.0F, _
             System.Drawing.FontStyle.Regular)
        Button1.Enabled = False
    End Sub

End Class

Comentarios

Puede aplicar ToolboxBitmapAttribute a un control para que los contenedores, como Microsoft Visual Studio diseñador de formularios, puedan recuperar un icono que represente el control.You can apply a ToolboxBitmapAttribute to a control so that containers, such as Microsoft Visual Studio Form Designer, can retrieve an icon that represents the control. El mapa de bits para el icono puede estar en un archivo por sí mismo o incrustado en el ensamblado que contiene el control.The bitmap for the icon can be in a file by itself or embedded in the assembly that contains the control. El tamaño del mapa de bits que se inserta en el ensamblado del control (o se almacena en un archivo independiente) debe ser de 16 por 16.The size of the bitmap that you embed in the control's assembly (or store in a separate file) should be 16 by 16. El GetImage método de un ToolboxBitmapAttribute objeto puede devolver la imagen pequeña de 16 por 16 o una imagen de 32 por 32 grande que se crea mediante el escalado de la imagen pequeña.The GetImage method of a ToolboxBitmapAttribute object can return the small 16 by 16 image or a large 32 by 32 image that it creates by scaling the small image.

Si desea usar versiones diferentes de los iconos con versiones diferentes del ensamblado, no tiene que modificar el ToolboxBitmapAttribute de cada versión.If you want to use different versions of your icons with different versions of your assembly, you do not have to modify the ToolboxBitmapAttribute for each version. En su lugar, puede declarar el ensamblado con BitmapSuffixInSameAssemblyAttribute BitmapSuffixInSatelliteAssemblyAttributeo, y especificar un BitmapSuffix valor de configuración para cada versión del ensamblado.Instead, you can declare the assembly with a BitmapSuffixInSameAssemblyAttribute or a BitmapSuffixInSatelliteAssemblyAttribute, and specify a BitmapSuffix configuration value for each assembly version. En este caso, un nombre de archivo indicado por ToolboxBitmapAttribute un se interpreta con el sufijo de mapa de bits anexado.In this case, a file name indicated by a ToolboxBitmapAttribute is interpreted with the bitmap suffix appended.

Constructores

ToolboxBitmapAttribute(String) ToolboxBitmapAttribute(String) ToolboxBitmapAttribute(String) ToolboxBitmapAttribute(String)

Inicializa un nuevo objeto ToolboxBitmapAttribute con una imagen a partir de un archivo especificado.Initializes a new ToolboxBitmapAttribute object with an image from a specified file.

ToolboxBitmapAttribute(Type) ToolboxBitmapAttribute(Type) ToolboxBitmapAttribute(Type) ToolboxBitmapAttribute(Type)

Inicializa un nuevo objeto ToolboxBitmapAttribute basado en un mapa de bits de 16 x 16 que se encuentra incrustado como un recurso en un ensamblado especificado.Initializes a new ToolboxBitmapAttribute object based on a 16 x 16 bitmap that is embedded as a resource in a specified assembly.

ToolboxBitmapAttribute(Type, String) ToolboxBitmapAttribute(Type, String) ToolboxBitmapAttribute(Type, String) ToolboxBitmapAttribute(Type, String)

Inicializa un nuevo objeto ToolboxBitmapAttribute basado en un mapa de bits de 16 por 16 que se encuentra incrustado como un recurso en un ensamblado especificado.Initializes a new ToolboxBitmapAttribute object based on a 16 by 16 bitmap that is embedded as a resource in a specified assembly.

Campos

Default Default Default Default

Objeto ToolboxBitmapAttribute cuya imagen pequeña e imagen grande están establecidas en null.A ToolboxBitmapAttribute object that has its small image and its large image set to null.

Métodos

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Indica si el objeto especificado es un objeto ToolboxBitmapAttribute y si es idéntico a este objeto ToolboxBitmapAttribute.Indicates whether the specified object is a ToolboxBitmapAttribute object and is identical to this ToolboxBitmapAttribute object.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Obtiene un código hash para este objeto ToolboxBitmapAttribute.Gets a hash code for this ToolboxBitmapAttribute object.

GetImage(Object) GetImage(Object) GetImage(Object) GetImage(Object)

Obtiene el objeto Image pequeño asociado a este objeto ToolboxBitmapAttribute.Gets the small Image associated with this ToolboxBitmapAttribute object.

GetImage(Object, Boolean) GetImage(Object, Boolean) GetImage(Object, Boolean) GetImage(Object, Boolean)

Obtiene el objeto Image pequeño o grande asociado a este objeto ToolboxBitmapAttribute.Gets the small or large Image associated with this ToolboxBitmapAttribute object.

GetImage(Type) GetImage(Type) GetImage(Type) GetImage(Type)

Obtiene el objeto Image pequeño asociado a este objeto ToolboxBitmapAttribute.Gets the small Image associated with this ToolboxBitmapAttribute object.

GetImage(Type, Boolean) GetImage(Type, Boolean) GetImage(Type, Boolean) GetImage(Type, Boolean)

Obtiene el objeto Image pequeño o grande asociado a este objeto ToolboxBitmapAttribute.Gets the small or large Image associated with this ToolboxBitmapAttribute object.

GetImage(Type, String, Boolean) GetImage(Type, String, Boolean) GetImage(Type, String, Boolean) GetImage(Type, String, Boolean)

Obtiene el objeto Image pequeño o grande asociado a este objeto ToolboxBitmapAttribute.Gets the small or large Image associated with this ToolboxBitmapAttribute object.

GetImageFromResource(Type, String, Boolean) GetImageFromResource(Type, String, Boolean) GetImageFromResource(Type, String, Boolean) GetImageFromResource(Type, String, Boolean)

Devuelve un objeto Image basado en un recurso de mapa de bits que se encuentra incrustado en un ensamblado.Returns an Image object based on a bitmap resource that is embedded in an assembly.

GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute()

Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object) Match(Object) Match(Object) Match(Object)

Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Implementaciones de interfaz explícitas

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Obtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32)

Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Proporciona acceso a las propiedades y los métodos expuestos por un objeto.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Propiedades

TypeId TypeId TypeId TypeId

Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

Se aplica a