演练:使用自定义组件自动填充工具箱

如果组件由当前打开的解决方案中的项目定义,它们将自动显示在 工具箱中,无需你执行任何作。 还可以使用“选择工具箱项”对话框(Visual Studio)手动填充工具箱,但工具箱将考虑解决方案生成输出中具有以下所有特征的项:

谨慎

此内容是为 .NET Framework 编写的。 如果使用 .NET 6 或更高版本,请谨慎使用此内容。 设计器系统已针对 Windows 窗体进行更改,因此请务必查看自 .NET Framework 以来对设计器所做的更改一文。

本演练演示生成组件后自定义组件如何在 工具箱 中自动显示。 本演练涉及以下任务:

  • 创建 Windows Forms 项目。

  • 创建自定义组件。

  • 创建自定义组件的实例。

  • 卸载和重新加载自定义组件。

完成后,你将看到 工具箱 已填充已创建的组件。

注释

工具箱仅显示由项目直接引用的库中的组件或解决方案中项目定义的组件。

创建项目

  1. 在 Visual Studio 中,创建一个名为(文件>新建>项目>Visual C#Visual Basic>经典桌面>Windows 窗体应用程序)的应用程序项目ToolboxExample

  2. 向项目添加新组件。 调用它 DemoComponent

    有关详细信息,请参阅 “如何:添加新项目项”。

  3. 构建项目。

  4. “工具” 菜单中,单击“ 选项” 项。 单击 Windows 窗体设计器项下的“常规”,并确保 AutoToolboxPopulate 选项设置为 True

创建自定义组件的实例

下一步是在窗体上创建自定义组件的实例。 由于 工具箱 自动为新组件帐户,因此创建任何其他组件或控件非常简单。

  1. 窗体设计器中打开项目的窗体。

  2. 在工具箱中,单击名为“ToolboxExample 组件”的新选项卡。

    单击选项卡后,将看到 DemoComponent

    注释

    出于性能原因, 工具箱 自动填充区域中的组件不显示自定义位图,不支持 ToolboxBitmapAttribute 。 若要在 工具箱中显示自定义组件的图标,请使用“ 选择工具箱项 ”对话框加载组件。

  3. 将组件拖到窗体上。

    创建组件实例并将其添加到 组件托盘

卸载和重新加载自定义组件

工具箱将考虑每个已加载项目中的组件,当卸载项目时,它将删除对项目组件的引用。

  1. 从解决方案中卸载项目。

    有关卸载项目的详细信息,请参阅 如何:卸载和重新加载项目。 如果系统提示保存,请选择“ ”。

  2. 向解决方案添加新 的 Windows 应用程序 项目。 在 设计器中打开窗体。

    上一个项目的 “工具箱Example 组件 ”选项卡现已消失。

  3. ToolboxExample项目重新加载。

    “工具箱Example 组件”选项卡现在重新出现。

后续步骤

本演练演示 工具箱 考虑了项目的组件,但 工具箱 也考虑了控件。 通过从解决方案中添加和删除控件项目来试验自己的自定义控件。

另请参阅