ToolboxBitmapAttribute 类  
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
这使您可以指定一个图标来表示容器的控件,例如 Microsoft Visual Studio 窗体设计器。
public ref class ToolboxBitmapAttribute : Attribute[System.AttributeUsage(System.AttributeTargets.Class)]
public class ToolboxBitmapAttribute : Attribute[<System.AttributeUsage(System.AttributeTargets.Class)>]
type ToolboxBitmapAttribute = class
    inherit AttributePublic Class ToolboxBitmapAttribute
Inherits Attribute- 继承
- 属性
示例
下面的代码示例演示如何使用 ToolboxBitmapAttribute 类将 设置为 stop.bmp 的 StopSignControl工具箱图标。 此示例假定存在名为 c:\的 16 x 16 像素位图 stop.bmp 。
[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
注解
可以将 应用于ToolboxBitmapAttribute控件,以便容器(如 Microsoft Visual Studio 窗体Designer)可以检索表示该控件的图标。 图标的位图可以单独位于文件中,也可以嵌入到包含控件的程序集中。 嵌入控件程序集 (或存储在单独文件中的位图的大小) 应为 16 乘 16。 GetImage对象的 方法ToolboxBitmapAttribute可以返回小 16 乘 16 的图像,也可以返回它通过缩放小图像创建的 32 乘 32 大图像。
若要将其他版本的图标用于不同版本的程序集,您无需修改每个版本的 ToolboxBitmapAttribute。 相反,您可使用 BitmapSuffixInSameAssemblyAttribute 或 BitmapSuffixInSatelliteAssemblyAttribute 声明此程集,并为每个程序集版本指定一个 BitmapSuffix 配置值。 在此情况下,使用追加的位图后缀来解释由 ToolboxBitmapAttribute 表示的文件名。
构造函数
| ToolboxBitmapAttribute(String) | 使用来自指定文件的图像初始化新的 ToolboxBitmapAttribute 对象。 | 
| ToolboxBitmapAttribute(Type) | 基于作为资源嵌入到指定程序集的一个 16 × 16 位图初始化新的 ToolboxBitmapAttribute 对象。 | 
| ToolboxBitmapAttribute(Type, String) | 基于作为资源嵌入到指定程序集的 16 × 16 位图,初始化新的 ToolboxBitmapAttribute 对象。 | 
字段
| Default | 一个 ToolboxBitmapAttribute 对象,其小图像和大图像均设置为  | 
属性
| TypeId | 在派生类中实现时,获取此 Attribute 的唯一标识符。(继承自 Attribute) | 
方法
| Equals(Object) | 指示指定的对象是否为 ToolboxBitmapAttribute 对象以及是否与此 ToolboxBitmapAttribute 对象相同。 | 
| GetHashCode() | 获取此 ToolboxBitmapAttribute 对象的哈希代码。 | 
| GetImage(Object) | 获取与此 Image 对象关联的小 ToolboxBitmapAttribute。 | 
| GetImage(Object, Boolean) | 获取与此 Image 对象关联的小或大 ToolboxBitmapAttribute。 | 
| GetImage(Type) | 获取与此 Image 对象关联的小 ToolboxBitmapAttribute。 | 
| GetImage(Type, Boolean) | 获取与此 Image 对象关联的小或大 ToolboxBitmapAttribute。 | 
| GetImage(Type, String, Boolean) | 获取与此 Image 对象关联的小或大 ToolboxBitmapAttribute。 | 
| GetImageFromResource(Type, String, Boolean) | 基于程序集中嵌入的位图资源返回 Image 对象。 | 
| GetType() | 获取当前实例的 Type。(继承自 Object) | 
| IsDefaultAttribute() | 在派生类中重写时,指示此实例的值是否是派生类的默认值。(继承自 Attribute) | 
| Match(Object) | 当在派生类中重写时,返回一个指示此实例是否等于指定对象的值。(继承自 Attribute) | 
| MemberwiseClone() | 创建当前 Object 的浅表副本。(继承自 Object) | 
| ToString() | 返回表示当前对象的字符串。(继承自 Object) | 
显式接口实现
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) | 将一组名称映射为对应的一组调度标识符。(继承自 Attribute) | 
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) | 检索对象的类型信息,然后可以使用该信息获取接口的类型信息。(继承自 Attribute) | 
| _Attribute.GetTypeInfoCount(UInt32) | 检索对象提供的类型信息接口的数量(0 或 1)。(继承自 Attribute) | 
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) | 提供对某一对象公开的属性和方法的访问。(继承自 Attribute) |