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

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

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

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

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

  • 在设计时测试控件的图标。

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

提示

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

系统必备

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

  • Visual Studio 2010.

创建自定义工具箱图标

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

创建自定义工具箱图标

  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 应用程序项目。

    MainWindow.xaml 将在 WPF 设计器中打开。 在“工具箱”中,**“CustomControl1”出现在“CustomControlWithToolboxIcon Controls”**选项卡中。

    带自定义控件的工具箱

  2. 在“工具箱”中,右击**“CustomControl1”并选择“删除”**。

  3. 在出现的消息框中,单击**“确定”**。

    **“CustomControl1”**将从“工具箱”中移除。

  4. 在“工具箱”中,右击要向其中添加控件的控件组,然后从上下文菜单中选择**“选择项”**。

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

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

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

  7. 在**“打开”对话框中,选择 CustomControlWithToolboxIcon.dll,然后单击“打开”**。

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

  8. 单击**“确定”**。

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

    自定义工具箱图标

请参见

任务

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

参考

“选择工具箱项”对话框 ->“WPF 组件”选项卡

其他资源

工具箱图标

使用资源

演练:为工具箱图标提供元数据