ToolboxBitmapAttribute Osztály

Definíció

Névtér:

System.Drawing

Szerelvény:

System.Drawing.Common.dll

Csomag:

System.Drawing.Common v11.0.0-preview.7.26381.103

Forrás:

ToolboxBitmapAttribute.cs

Lehetővé teszi egy ikon megadását egy tároló vezérlőelemének, például a Microsoft Visual Studio Űrlaptervezőnek a megjelenítéséhez.

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

Öröklődés

Object

Attribute

ToolboxBitmapAttribute

Attribútumok

AttributeUsageAttribute

Példák

Az alábbi példakód bemutatja, hogyan állíthatja be ToolboxBitmapAttribute az stop.bmp osztályt eszközkészlet ikonként a StopSignControl. Ez a példa feltételezi, hogy létezik egy 16-by-16 képpontos bitkép, amely a következő helyen található stop.bmp : 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

Megjegyzések

A vezérlőkre ToolboxBitmapAttribute alkalmazhat, így a tárolók, például Microsoft Visual Studio Űrlaptervező, lekérhetik a vezérlőt jelképező ikont. Az ikon bitképe lehet önmagában egy fájlban, vagy beágyazható a vezérlőt tartalmazó szerelvénybe. A vezérlő szerelvényében (vagy egy külön fájlban tárolva) beágyazott bitkép mérete 16 és 16 között lehet. Egy GetImage objektum metódusa ToolboxBitmapAttribute visszaadhatja a kis 16-16 kép vagy egy nagy 32-32 kép, amelyet a kis kép skálázásával hoz létre.

Ha az ikonok különböző verzióit szeretné használni a szerelvény különböző verzióival, nem kell módosítania az ToolboxBitmapAttribute egyes verziókhoz tartozókat. Ehelyett deklarálhatja a szerelvényt egy BitmapSuffixInSameAssemblyAttribute vagy egy BitmapSuffixInSatelliteAssemblyAttribute, és megadhat egy BitmapSuffix konfigurációs értéket az egyes szerelvényverziókhoz. Ebben az esetben a rendszer a bitkép utótaggal együtt értelmezi az a fájlnevet, amelyet egy ToolboxBitmapAttribute adott személy jelez.

Konstruktorok

Name	Description
ToolboxBitmapAttribute(String)	Inicializál egy új ToolboxBitmapAttribute objektumot egy megadott fájlból származó képpel.
ToolboxBitmapAttribute(Type, String)	Inicializál egy új ToolboxBitmapAttribute objektumot egy 16–16 bites leképezés alapján, amely erőforrásként van beágyazva egy adott szerelvénybe.
ToolboxBitmapAttribute(Type)	Inicializál egy új ToolboxBitmapAttribute objektumot egy 16 x 16 bites rendszerkép alapján, amely erőforrásként van beágyazva egy adott szerelvénybe.

Mezők

Name	Description
Default	Egy ToolboxBitmapAttribute objektum, amelynek kis képe és nagy képe a következőre nullvan állítva: .

Metódusok

Name	Description
Equals(Object)	Azt jelzi, hogy a megadott objektum objektum-e ToolboxBitmapAttribute , és azonos-e ezzel az ToolboxBitmapAttribute objektummal.
GetHashCode()	Lekéri az ToolboxBitmapAttribute objektum kivonatkódját.
GetImage(Object, Boolean)	Lekéri az objektumhoz Image társított kicsi vagy nagy ToolboxBitmapAttribute méretűt.
GetImage(Object)	Lekéri az objektumhoz Image társított kis ToolboxBitmapAttribute méretűt.
GetImage(Type, Boolean)	Lekéri az objektumhoz Image társított kicsi vagy nagy ToolboxBitmapAttribute méretűt.
GetImage(Type, String, Boolean)	Lekéri az objektumhoz Image társított kicsi vagy nagy ToolboxBitmapAttribute méretűt.
GetImage(Type)	Lekéri az objektumhoz Image társított kis ToolboxBitmapAttribute méretűt.
GetImageFromResource(Type, String, Boolean)	Image Egy szerelvénybe beágyazott bitkép-erőforráson alapuló objektumot ad vissza.