在工具箱中设置控件的图标(Windows 窗体 .NET)

你创建的控件始终会收到 Visual Studio 中工具箱窗口的通用图标。 但是,当你更改图标时,它会为控件增添专业感,并使其在工具箱中脱颖而出。 本文介绍如何设置控件的图标。

位图图标

Visual Studio 中工具箱窗口的图标必须符合某些标准,否则它们将被忽略或错误显示。

  • 大小:控件的图标必须是 16x16 位图图像。
  • 文件类型:图标可以是位图 (.bmp) 或 Windows 图标 (.ico) 文件。
  • 透明度:洋红色(RGB:255,0,255,Hex:0xFF00FF)呈现透明。
  • 主题:Visual Studio 有多个主题,但每个主题要么是深色,要么是浅色。 你的图标应设计为浅色主题。 当 Visual Studio 使用深色主题时,图标中的深色和浅色将自动反转。

如何分配图标

图标分配给具有 ToolboxBitmapAttribute 特性的控件。 有关属性的详细信息,请参阅特性 (C#)特性概述 (Visual Basic)

提示

可以从 GitHub 下载示例图标。

该特性设置在控件的类上,它具有三个不同的构造函数:

  • ToolboxBitmapAttribute(Type) - 此构造函数接收单个类型引用,并会从该类型尝试查找用作图标的嵌入资源。

    该类型的 FullName 用于在该类型的程序集中查找嵌入资源,格式如下:{project-name}.{namespace-path}.{type-name}{.bmp|.ico}。 例如,如果引用了 MyProject.MyNamespace.CompassRose 类型,则特性将查找名为 MyProject.MyNamespace.CompassRose.bmpMyProject.MyNamespace.CompassRose.ico 的嵌入资源。

    // Looks for a CompassRose.bmp or CompassRose.ico embedded resource in the
    // same namespace as the CompassRose type.
    [ToolboxBitmap(typeof(CompassRose))]
    public partial class CompassRose : UserControl
    {
        // Code for the control
    }
    
    ' Looks for a CompassRose.bmp or CompassRose.ico embedded resource in the
    ' same namespace as the CompassRose type.
    <ToolboxBitmap(GetType(CompassRose))>
    Public Class CompassRose
        ' Code for the control
    End Class
    
  • ToolboxBitmapAttribute(Type, String) - 此构造函数接收两个参数。 第一个参数是一种类型,第二个参数是该类型的程序集中嵌入资源的命名空间和名称。

    // Loads the icon from the WinFormsApp1.Resources.CompassRose.bmp resource
    // in the assembly containing the type CompassRose
    [ToolboxBitmap(typeof(CompassRose), "WinFormsApp1.Resources.CompassRose.bmp")]
    public partial class CompassRose : UserControl
    {
        // Code for the control
    }
    
    ' Loads the icon from the WinFormsApp1.Resources.CompassRose.bmp resource
    ' in the assembly containing the type CompassRose
    <ToolboxBitmap(GetType(CompassRose), "WinFormsApp1.Resources.CompassRose.bmp")>
    Public Class CompassRose
        ' Code for the control
    End Class
    
  • ToolboxBitmapAttribute(String) - 此构造函数接收单个字符串参数,即图标文件的绝对路径。

    // Loads the icon from a file on disk
    [ToolboxBitmap(@"C:\Files\Resources\MyIcon.bmp")]
    public partial class CompassRose : UserControl
    {
        // Code for the control
    }
    
    ' Loads the icon from a file on disk
    <ToolboxBitmap("C:\Files\Resources\MyIcon.bmp")>
    Public Class CompassRose
        ' Code for the control
    End Class