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

[本文档仅供预览，在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]

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

在本演练中，您将执行下列任务：

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

备注

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

系统必备

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

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

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

CustomControl1 的代码在“代码编辑器”中打开。
从**“项目”菜单中选择“添加新项”**。

**“添加新项”**对话框打开。
在**“添加新项”对话框中，选择“常规”**类别。
在模板列表中，选择**“位图文件”，将新文件命名为 CustomControl1.Icon.bmp，然后单击“添加”**。

将打开图像编辑器。
在“属性”窗口中，将位图的**“颜色”**属性设置为 24 bit。
使用图像编辑器工具在位图中绘制图像。有关更多信息，请参见图标的图像编辑器。
在**“解决方案资源管理器”**中，选择 CustomControl1.Icon.bmp。
在“属性”窗口中，将**“生成操作”属性设置为“嵌入的资源”**。
生成解决方案。

有关更多信息，请参见工具箱图标。

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

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

MainWindow.xaml 将在 WPF Designer中打开。在“工具箱”中，**“CustomControl1”出现在“CustomControlWithToolboxIcon Controls”**选项卡中。
在“工具箱”中，右击**“CustomControl1”并选择“删除”**。
在出现的消息框中，单击**“确定”**。

**“CustomControl1”**将从“工具箱”中移除。
在“工具箱”中，右击要向其中添加控件的控件组，然后从上下文菜单中选择**“选择项”**。

**“选择工具箱项”**对话框随即打开。
在**“选择工具箱项”对话框中，单击“WPF 组件”**选项卡。有关更多信息，请参见选择工具箱项， WPF 元素。
单击**“浏览”**，并导航到 CustomControlWithToolboxIcon 项目的 bin\Debug 文件夹。
在**“打开”对话框中，选择 CustomControlWithToolboxIcon.dll，然后单击“打开”**。

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

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