操作指南:自动将自定义组件填充到工具箱中
如果组件由当前打开的解决方案中的项目定义,它们将自动显示在 工具箱中,无需你执行任何操作。 您还可以通过使用“选择工具箱项”对话框(Visual Studio)来自定义填充工具箱。同时,工具箱会考虑解决方案的构建输出中具有以下所有特征的项:
实现 IComponent;
未将 ToolboxItemAttribute 设置为
false
;未将 DesignTimeVisibleAttribute 设置为
false
。
注意
工具箱 不遵循引用链,因此它不会显示解决方案中项目未生成的项。
本演练演示生成组件后,自定义组件如何自动显示在 工具箱 中。 本演练中演示的任务包括:
创建 Windows 窗体项目。
创建自定义组件。
创建自定义组件的实例。
卸载和重新加载自定义组件。
完成后,你将看到 工具箱 填充了已创建的组件。
创建项目
在 Visual Studio 中,创建一个名为“
ToolboxExample
”的基于 Windows 的应用程序项目(文件>新建>项目>Visual C# 或 Visual Basic>经典桌面>Windows 窗体应用程序)。向项目添加新组件。 称之为
DemoComponent
。有关详细信息,请参阅 如何:添加新项目项。
构建项目。
在 工具 菜单中,单击 选项 项。 单击 常规 项下的 Windows 窗体设计器,并确保 AutoToolboxPopulate 选项设置为 True。
创建自定义组件的实例
下一步是在窗体上创建自定义组件的实例。 由于 工具箱 自动处理新组件,因此这与创建其他组件或控件一样简单。
在 窗体设计器中打开项目窗体。
在 工具箱中,单击名为 ToolboxExample 组件的新选项卡。
单击选项卡后,你将看到 DemoComponent。
注意
出于性能原因,工具箱 自动填充区域中的组件不显示自定义位图,不支持 ToolboxBitmapAttribute。 若要在 工具箱中显示自定义组件的图标,请使用 选择工具箱项 对话框加载组件。
将组件拖到窗体上。
创建组件实例并将其添加到 组件托盘。
卸载和重新加载自定义组件
工具箱 会考虑每个加载项目中的组件,并在卸载项目时删除对项目的组件的引用。
从解决方案中卸载项目。
有关卸载项目的详细信息,请参考 如何:卸载和重载项目。 如果系统提示保存,请选择“是”。
向解决方案中添加一个新的 Windows 应用程序 项目。 在 设计器中打开窗体。
“工具箱组件”选项卡从上一个项目中现已消失。
重新加载
ToolboxExample
项目。工具箱示例组件 选项卡现在重新出现。
后续步骤
本演练演示了 工具箱 在考虑项目的组件时,工具箱 也会考量控件。 通过从解决方案中添加和删除控件项目来试验自己的自定义控件。