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