ToolboxBitmapAttribute Klasse

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Quelle:

ToolboxBitmapAttribute.cs

Ermöglicht Ihnen, ein Symbol anzugeben, das ein Steuerelement in einem Container darstellt, z. B. in Microsoft Visual Studio Form Designer.

public ref class ToolboxBitmapAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Class)]
public class ToolboxBitmapAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class)>]
type ToolboxBitmapAttribute = class
    inherit Attribute

Public Class ToolboxBitmapAttribute
Inherits Attribute

Vererbung

Object

Attribute

ToolboxBitmapAttribute

Attribute

AttributeUsageAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die ToolboxBitmapAttribute -Klasse als stop.bmp Toolboxsymbol für festgelegt wird StopSignControl. In diesem Beispiel wird davon ausgegangen, dass eine Bitmap mit 16 x 16 Pixeln mit dem Namen stop.bmp c:\vorhanden ist.

[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

Hinweise

Sie können ein ToolboxBitmapAttribute auf ein Steuerelement anwenden, damit Container, z. B. Microsoft Visual Studio Form Designer, ein Symbol abrufen können, das das Steuerelement darstellt. Die Bitmap für das Symbol kann sich in einer Datei befinden oder in die Assembly eingebettet sein, die das Steuerelement enthält. Die Größe der Bitmap, die Sie in die Assembly des Steuerelements einbetten (oder in einer separaten Datei speichern), sollte 16 x 16 sein. Die GetImage -Methode eines ToolboxBitmapAttribute Objekts kann das kleine 16 mal 16-Bild oder ein großes 32 x 32-Bild zurückgeben, das durch Skalierung des kleinen Bilds erstellt wird.

Wenn Sie verschiedene Versionen Ihrer Symbole mit unterschiedlichen Versionen Ihrer Assembly verwenden möchten, müssen Sie die ToolboxBitmapAttribute nicht für jede Version ändern. Stattdessen können Sie die Assembly mit einem BitmapSuffixInSameAssemblyAttribute oder einem BitmapSuffixInSatelliteAssemblyAttributedeklarieren und einen BitmapSuffix Konfigurationswert für jede Assemblyversion angeben. In diesem Fall wird ein durch einen ToolboxBitmapAttribute angegebenen Dateinamen mit dem Bitmapsuffix interpretiert.

Konstruktoren

ToolboxBitmapAttribute(String)	Initialisiert ein neues ToolboxBitmapAttribute-Objekt mit einem Bild aus einer angegebenen Datei.
ToolboxBitmapAttribute(Type)	Initialisiert ein neues ToolboxBitmapAttribute-Objekt auf Grundlage einer 16 x 16-Bitmap, die als Ressource in einer angegebenen Assembly eingebettet ist.
ToolboxBitmapAttribute(Type, String)	Initialisiert ein neues ToolboxBitmapAttribute-Objekt auf Grundlage einer 16 x 16-Bitmap, die als Ressource in einer angegebenen Assembly eingebettet ist.

Felder

Default

Ein ToolboxBitmapAttribute-Objekt, dessen kleines und großes Bild auf null festgelegt sind.

Eigenschaften

TypeId

Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)

Methoden

Equals(Object)	Gibt an, ob das angegebene Objekt ein ToolboxBitmapAttribute-Objekt und mit diesem ToolboxBitmapAttribute-Objekt identisch ist.
GetHashCode()	Ruft einen Hashcode für dieses ToolboxBitmapAttribute-Objekt ab.
GetImage(Object)	Ruft das kleine Image ab, das diesem ToolboxBitmapAttribute-Objekt zugeordnet ist.
GetImage(Object, Boolean)	Ruft das kleine oder große Image ab, das diesem ToolboxBitmapAttribute-Objekt zugeordnet ist.
GetImage(Type)	Ruft das kleine Image ab, das diesem ToolboxBitmapAttribute-Objekt zugeordnet ist.
GetImage(Type, Boolean)	Ruft das kleine oder große Image ab, das diesem ToolboxBitmapAttribute-Objekt zugeordnet ist.
GetImage(Type, String, Boolean)	Ruft das kleine oder große Image ab, das diesem ToolboxBitmapAttribute-Objekt zugeordnet ist.
GetImageFromResource(Type, String, Boolean)	Gibt ein Image-Objekt auf Grundlage einer in einer Assembly eingebetteten Bitmapressource zurück.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)