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

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

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

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

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

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

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

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

系统必备



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

Visual Studio 2010.

创建自定义工具箱图标



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

创建自定义工具箱图标

使用 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”连同其对应的图标显示在“工具箱”中。