更新:2007 年 11 月
本演练演示如何为 Windows 演示基础 (WPF) 自定义控件创建工具箱图标。将自定义控件添加到工具箱时,该图标将显示在控件的名称旁边。
在本演练中,您将执行下列任务:
创建一个 WPF 自定义控件库项目。
为控件的工具箱图标创建自定义位图文件。
在设计时测试控件。
完成本演练后,您将了解如何为自定义控件创建工具箱图标。
![]() |
---|
显示的对话框和菜单命令可能会与“帮助”中的描述不同,具体取决于您的当前设置或版本。若要更改设置,请在“工具”菜单上选择“导入和导出设置”。有关更多信息,请参见 Visual Studio 设置。 |
先决条件
您需要以下组件来完成本演练:
- Visual Studio 2008。
创建自定义工具箱图标
若要为控件创建自定义工具箱图标,请将一个图像作为嵌入资源添加到控件的项目中。
创建自定义工具箱图标
使用 Visual Basic 或 Visual C# 新建一个名为 CustomControlWithToolboxIcon 的 WPF 自定义控件库项目。
CustomControl1 的代码在“代码编辑器”中打开。
从“项目”菜单中选择“添加新项”。
“添加新项”对话框打开。
在“添加新项”对话框中,选择“常规”类别。
在“模板”窗格中选择“位图文件”,将新文件命名为 CustomControl1.Icon.bmp,然后单击“添加”。将打开图像编辑器。
在“属性”窗口中,将位图的“颜色”属性设置为 24 bit。
使用图像编辑器工具在位图中绘制图像。有关更多信息,请参见 图像编辑器。
在“解决方案资源管理器”中,选择 CustomControl1.Icon.bmp。
在“属性”窗口中,将“生成操作”属性设置为“嵌入的资源”。
生成解决方案。
有关更多信息,请参见 工具箱图标和嵌入资源。
测试工具箱图标
通过将 CustomControl1 添加到工具箱来测试您的自定义工具箱图标。
测试工具箱图标
使用 Visual Basic 或 Visual C# 在解决方案中添加一个名为 TestApplication 的新 WPF 应用程序项目。
Window1.xaml 在 WPF 设计器中打开。
添加对 CustomControlWithToolboxIcon 项目的引用。
在工具箱中右击并从上下文菜单中选择“选择项…”。
“选择工具箱项”对话框打开。
在“选择工具箱项”对话框中,单击“WPF 组件”选项卡。有关更多信息,请参见 “选择工具箱项”对话框 ->“WPF 组件”选项卡。
单击“浏览”,并导航到 CustomControlWithToolboxIcon 项目的 bin\Debug 文件夹。
双击 CustomControlWithToolboxIcon.dll 将它选中。
CustomControlWithToolboxIcon 程序集的详细信息显示在“选择工具箱项”对话框中。您的自定义图标显示在“CustomControl1”组框中。
单击“确定”。
CustomControl1 连同其对应的图标显示在工具箱中。