ToolboxBitmapAttribute Classe

Definizione

Consente di specificare un'icona per rappresentare un controllo in un contenitore, quale Progettazione form di 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
Ereditarietà
ToolboxBitmapAttribute
Attributi

Esempi

Nell'esempio di codice riportato di seguito viene illustrato ToolboxBitmapAttribute come utilizzare la stop.bmp classe per impostare come icona della StopSignControlcasella degli strumenti per l'oggetto.The following code example demonstrates how to use the ToolboxBitmapAttribute class to set stop.bmp as the toolbox icon for the StopSignControl. In questo esempio si presuppone l'esistenza di una bitmap 16 per 16 pixel denominata stop.bmp in 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

Commenti

È possibile applicare un ToolboxBitmapAttribute oggetto a un controllo in modo che i contenitori, ad esempio Microsoft Visual Studio Designer Form, possano recuperare un'icona che rappresenta il controllo.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. La bitmap per l'icona può trovarsi in un file da solo o incorporata nell'assembly che contiene il controllo.The bitmap for the icon can be in a file by itself or embedded in the assembly that contains the control. La dimensione della bitmap incorporata nell'assembly del controllo o in un file separato deve essere 16 per 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. Il GetImage metodo di un ToolboxBitmapAttribute oggetto può restituire la piccola immagine da 16 a 16 o un'immagine 32 di grandi dimensioni di 32 creata ridimensionando l'immagine piccola.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.

Se si desidera utilizzare versioni diverse delle icone con versioni diverse dell'assembly, non è necessario modificare ToolboxBitmapAttribute per ogni versione.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. In alternativa, è possibile dichiarare l'assembly con BitmapSuffixInSameAssemblyAttribute o BitmapSuffixInSatelliteAssemblyAttribute e specificare un valore di configurazione di BitmapSuffix per ogni assembly.Instead, you can declare the assembly with a BitmapSuffixInSameAssemblyAttribute or a BitmapSuffixInSatelliteAssemblyAttribute, and specify a BitmapSuffix configuration value for each assembly version. In questo caso, un nome file indicato da ToolboxBitmapAttribute viene interpretato con l'aggiunta del suffisso bitmap.In this case, a file name indicated by a ToolboxBitmapAttribute is interpreted with the bitmap suffix appended.

Costruttori

ToolboxBitmapAttribute(String)

Inizializza un nuovo oggetto ToolboxBitmapAttribute con un'immagine da un file specificato.Initializes a new ToolboxBitmapAttribute object with an image from a specified file.

ToolboxBitmapAttribute(Type)

Inizializza un nuovo oggetto ToolboxBitmapAttribute basato su una bitmap 16 x 16 incorporata come risorsa in un'assembly specificata.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)

Inizializza un nuovo oggetto ToolboxBitmapAttribute basato su una bitmap 16 x 16 incorporata come risorsa in un'assembly specificata.Initializes a new ToolboxBitmapAttribute object based on a 16 by 16 bitmap that is embedded as a resource in a specified assembly.

Campi

Default

Oggetto ToolboxBitmapAttribute che ha l'immagine piccola e l'immagine grande impostate su null .A ToolboxBitmapAttribute object that has its small image and its large image set to null.

Proprietà

TypeId

Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Ereditato da Attribute)

Metodi

Equals(Object)

Indica se l'oggetto specificato è un oggetto ToolboxBitmapAttribute ed è identico a questo oggetto ToolboxBitmapAttribute.Indicates whether the specified object is a ToolboxBitmapAttribute object and is identical to this ToolboxBitmapAttribute object.

GetHashCode()

Ottiene un codice hash per questo oggetto ToolboxBitmapAttribute.Gets a hash code for this ToolboxBitmapAttribute object.

GetImage(Object)

Ottiene l'Image piccola associata all'oggetto ToolboxBitmapAttribute.Gets the small Image associated with this ToolboxBitmapAttribute object.

GetImage(Object, Boolean)

Ottiene l'Image piccola o grande associata all'oggetto ToolboxBitmapAttribute.Gets the small or large Image associated with this ToolboxBitmapAttribute object.

GetImage(Type)

Ottiene l'Image piccola associata all'oggetto ToolboxBitmapAttribute.Gets the small Image associated with this ToolboxBitmapAttribute object.

GetImage(Type, Boolean)

Ottiene l'Image piccola o grande associata all'oggetto ToolboxBitmapAttribute.Gets the small or large Image associated with this ToolboxBitmapAttribute object.

GetImage(Type, String, Boolean)

Ottiene l'Image piccola o grande associata all'oggetto ToolboxBitmapAttribute.Gets the small or large Image associated with this ToolboxBitmapAttribute object.

GetImageFromResource(Type, String, Boolean)

Restituisce un oggetto Image basato su una risorsa della bitmap incorporata in un'assembly.Returns an Image object based on a bitmap resource that is embedded in an assembly.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
IsDefaultAttribute()

In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Ereditato da Attribute)
Match(Object)

Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Ereditato da Attribute)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Implementazioni dell'interfaccia esplicita

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

Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch.Maps a set of names to a corresponding set of dispatch identifiers.

(Ereditato da Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera le informazioni sul tipo relative a un oggetto, che possono essere usate per ottenere informazioni sul tipo relative a un'interfaccia.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Ereditato da Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Ereditato da Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornisce l'accesso a proprietà e metodi esposti da un oggetto.Provides access to properties and methods exposed by an object.

(Ereditato da Attribute)

Si applica a