演练:为控件创建自定义工具箱图标

更新:2007 年 11 月

本演练演示如何为 Windows 演示基础 (WPF) 自定义控件创建工具箱图标。将自定义控件添加到工具箱时,该图标将显示在控件的名称旁边。

在本演练中,您将执行下列任务:

  • 创建一个 WPF 自定义控件库项目。

  • 为控件的工具箱图标创建自定义位图文件。

  • 在设计时测试控件。

完成本演练后,您将了解如何为自定义控件创建工具箱图标。

说明:

显示的对话框和菜单命令可能会与“帮助”中的描述不同,具体取决于您的当前设置或版本。若要更改设置,请在“工具”菜单上选择“导入和导出设置”。有关更多信息,请参见 Visual Studio 设置

先决条件

您需要以下组件来完成本演练:

  • Visual Studio 2008。

创建自定义工具箱图标

若要为控件创建自定义工具箱图标,请将一个图像作为嵌入资源添加到控件的项目中。

创建自定义工具箱图标

  1. 使用 Visual Basic 或 Visual C# 新建一个名为 CustomControlWithToolboxIcon 的 WPF 自定义控件库项目。

    CustomControl1 的代码在“代码编辑器”中打开。

  2. 从“项目”菜单中选择“添加新项”。

    “添加新项”对话框打开。

  3. 在“添加新项”对话框中,选择“常规”类别。

  4. 在“模板”窗格中选择“位图文件”,将新文件命名为 CustomControl1.Icon.bmp,然后单击“添加”。将打开图像编辑器。

  5. 在“属性”窗口中,将位图的“颜色”属性设置为 24 bit。

  6. 使用图像编辑器工具在位图中绘制图像。有关更多信息,请参见 图像编辑器

  7. 在“解决方案资源管理器”中,选择 CustomControl1.Icon.bmp。

  8. 在“属性”窗口中,将“生成操作”属性设置为“嵌入的资源”。

  9. 生成解决方案。

    有关更多信息,请参见 工具箱图标和嵌入资源

测试工具箱图标

通过将 CustomControl1 添加到工具箱来测试您的自定义工具箱图标。

测试工具箱图标

  1. 使用 Visual Basic 或 Visual C# 在解决方案中添加一个名为 TestApplication 的新 WPF 应用程序项目。

    Window1.xaml 在 WPF 设计器中打开。

  2. 添加对 CustomControlWithToolboxIcon 项目的引用。

  3. 在工具箱中右击并从上下文菜单中选择“选择项…”。

    “选择工具箱项”对话框打开。

  4. 在“选择工具箱项”对话框中,单击“WPF 组件”选项卡。有关更多信息,请参见 “选择工具箱项”对话框 ->“WPF 组件”选项卡

  5. 单击“浏览”,并导航到 CustomControlWithToolboxIcon 项目的 bin\Debug 文件夹。

  6. 双击 CustomControlWithToolboxIcon.dll 将它选中。

    CustomControlWithToolboxIcon 程序集的详细信息显示在“选择工具箱项”对话框中。您的自定义图标显示在“CustomControl1”组框中。

  7. 单击“确定”。

    CustomControl1 连同其对应的图标显示在工具箱中。

请参见

任务

如何:在程序集中嵌入图标

概念

工具箱图标和嵌入资源

其他资源

基本扩展性概念