Allows you to specify an icon to represent a control in a container, such as the Microsoft Visual Studio Form Designer.
Namespace:
System.Drawing
Assembly:
System.Drawing (in System.Drawing.dll)
Visual Basic (Declaration)
<AttributeUsageAttribute(AttributeTargets.Class)> _
Public Class ToolboxBitmapAttribute _
Inherits Attribute
Dim instance As ToolboxBitmapAttribute
[AttributeUsageAttribute(AttributeTargets.Class)]
public class ToolboxBitmapAttribute : Attribute
[AttributeUsageAttribute(AttributeTargets::Class)]
public ref class ToolboxBitmapAttribute : public Attribute
public class ToolboxBitmapAttribute extends Attribute
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. The bitmap for the icon can be in a file by itself or embedded in the assembly that contains the control. The size of the bitmap that you embed in the control's assembly (or store in a separate file) should be 16 by 16. 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.
The following code example demonstrates how to use the ToolboxBitmapAttribute class to set stop.bmp as the toolbox icon for the StopSignControl. This example assumes the existence of a 16-by-16-pixel bitmap named stop.bmp at c:\.
<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
[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;
}
}
[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..::.Object
System..::.Attribute
System.Drawing..::.ToolboxBitmapAttribute
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
.NET Framework
Supported in: 3.5, 3.0, 2.0, 1.1, 1.0
Reference