演练:使用自定义组件自动填充工具箱
更新:2007 年 11 月
如果组件是由当前打开的解决方案中的项目定义的,那么无需任何操作,这些组件就会自动出现在“工具箱”中。还可以通过使用 “选择工具箱项”对话框 (Visual Studio) 用自定义组件手动填充“工具箱”,但“工具箱”在考虑解决方案的生成输出结果中的各项时需具有以下全部特点:
实现 IComponent;
没有将 ToolboxItemAttribute 设置为 false;
没有将 DesignTimeVisibleAttribute 设置为 false。
说明: |
---|
“工具箱”不会遵循引用链,因此它将不显示并非由解决方案中的项目生成的各项。 |
本演练演示在构建了自定义组件之后,它如何自动出现在“工具箱”中。本演练涉及以下任务:
创建 Windows 窗体项目。
创建自定义组件。
创建自定义组件的实例。
卸载和重新加载自定义组件。
完成后,将会看到“工具箱”中填充了所创建的组件。
说明: |
---|
显示的对话框和菜单命令可能会与“帮助”中的描述不同,具体取决于您的当前设置或版本。若要更改设置,请在“工具”菜单上选择“导入和导出设置”。有关更多信息,请参见 Visual Studio 设置。 |
创建项目
第一步是创建项目并设置窗体。
创建项目
创建一个名为 ToolboxExample 的基于 Windows 的应用程序项目。
有关更多信息,请参见如何:创建 Windows 应用程序项目。
向项目添加新的组件。将其命名为 DemoComponent。
有关更多信息,请参见如何:添加新项目项。
生成项目。
在“工具”菜单上单击“选项”项。单击“Windows 窗体设计器”项下面的“常规”,并确保“AutoToolboxPopulate”选项设置为“True”。
创建自定义组件的实例
下一步是窗体上创建自定义组件的实例。因为“工具箱”会自动解释新组件,所以这和创建任何其他组件或控件一样简单。
创建自定义组件的实例
在“窗体设计器”中打开该项目的窗体。
在“工具箱”中,单击名为“ToolboxExample 组件”的新选项卡。
单击该选项卡后将会看到“DemoComponent”。
说明: 由于性能的原因,“工具箱”的自动填充区域中的组件不显示自定义位图,并且不支持 ToolboxBitmapAttribute。若要在“工具箱”中显示自定义组件的图标,请使用“选择工具箱项”对话框加载您的组件。
将组件拖到窗体上。
这样将创建该组件的一个实例,并将其添加到“组件栏”。
卸载并重新加载自定义组件
“工具箱”考虑每个加载项目中的组件,当卸载项目时,它将移除对该项目组件的引用。
试验卸载和重新加载组件对工具箱的影响
从解决方案卸载该项目。
有关卸载项目的更多信息,请参见 如何:卸载和重新加载项目。如果提示保存,选择“是”。
将新的“Windows 应用程序”项目添加到解决方案。在“设计器”中打开窗体。
前个项目中的“ToolboxExample 组件”选项卡现在不见了。
重新加载 ToolboxExample 项目。
现在重新出现“ToolboxExample 组件”选项卡。
后续步骤
本演练演示了“工具箱”会考虑项目的组件,但“工具箱”同时也会考虑控件。可以通过添加和移除解决方案中的控件项目来试验自定义控件。
请参见
任务
参考
“选项”对话框 ->“Windows 窗体设计器”->“常规”