ToolboxService.CreateItemContainer 方法

定义

命名空间:

System.Drawing.Design

程序集:

System.Drawing.Design.dll

从工具箱项或保存的数据对象创建一个新的工具箱项容器。

重载

CreateItemContainer(IDataObject)	从保存的数据对象创建一个新的工具箱项容器。
CreateItemContainer(ToolboxItem, IDesignerHost)	从工具箱项创建一个新的工具箱项容器。

CreateItemContainer(IDataObject)

从保存的数据对象创建一个新的工具箱项容器。

protected:
 virtual System::Drawing::Design::ToolboxItemContainer ^ CreateItemContainer(System::Windows::Forms::IDataObject ^ dataObject);

protected virtual System.Drawing.Design.ToolboxItemContainer CreateItemContainer (System.Windows.Forms.IDataObject dataObject);

abstract member CreateItemContainer : System.Windows.Forms.IDataObject -> System.Drawing.Design.ToolboxItemContainer
override this.CreateItemContainer : System.Windows.Forms.IDataObject -> System.Drawing.Design.ToolboxItemContainer

Protected Overridable Function CreateItemContainer (dataObject As IDataObject) As ToolboxItemContainer

参数

dataObject

IDataObject

包含保存的工具箱数据的数据对象。

返回

ToolboxItemContainer

新的工具箱项容器。

例外

ArgumentNullException

dataObject 为 null。

注解

方法 CreateItemContainer 使你有机会提供 的 ToolboxItemContainer派生版本。 默认情况下， ToolboxService 类不支持链接项，因此对于不是 null的链接参数，它返回 null 。 若要提供链接支持，应重写此方法以创建能够处理链接的派生 ToolboxItemContainer 。

传入的数据对象应包含从对工具箱项容器的 属性的先前调用 ToolboxItemContainer.ToolboxData 中获得的数据。

继承者说明

链接的工具箱项是其存在与特定设计器主机的存储相关联的工具箱项。 因此，在典型的项目系统中，设计器主机与特定文件相关联。 当从项目中删除设计器宿主的源文件时，链接到设计器宿主的工具箱项将自动从工具箱中删除。

链接工具箱项可以实现一些方案，例如在打开Windows 窗体设计器时禁用 ASP.NET 工具箱项。

CreateItemContainer(ToolboxItem, IDesignerHost)

从工具箱项创建一个新的工具箱项容器。

protected:
 virtual System::Drawing::Design::ToolboxItemContainer ^ CreateItemContainer(System::Drawing::Design::ToolboxItem ^ item, System::ComponentModel::Design::IDesignerHost ^ link);

protected virtual System.Drawing.Design.ToolboxItemContainer CreateItemContainer (System.Drawing.Design.ToolboxItem item, System.ComponentModel.Design.IDesignerHost link);

abstract member CreateItemContainer : System.Drawing.Design.ToolboxItem * System.ComponentModel.Design.IDesignerHost -> System.Drawing.Design.ToolboxItemContainer
override this.CreateItemContainer : System.Drawing.Design.ToolboxItem * System.ComponentModel.Design.IDesignerHost -> System.Drawing.Design.ToolboxItemContainer

Protected Overridable Function CreateItemContainer (item As ToolboxItem, link As IDesignerHost) As ToolboxItemContainer

参数

item

ToolboxItem

为其创建项容器的工具箱项。

link

IDesignerHost

应当链接至此工具箱项的可选设计器宿主。 此参数可以为 null。

返回

ToolboxItemContainer

新的工具箱项容器。

例外

ArgumentNullException

item 为 null。

注解

方法 CreateItemContainer 使你有机会提供 的 ToolboxItemContainer派生版本。 默认情况下， ToolboxService 类不支持链接项，因此对于不是 null的链接参数，它返回 null 。 若要提供链接支持，应重写此方法以创建能够处理链接的派生 ToolboxItemContainer 。

如果分配了提供 IDesignerHost 的链接参数，则表示这是链接的工具箱项。

继承者说明

链接的工具箱项是其存在与特定设计器主机的存储相关联的工具箱项。 因此，在典型的项目系统中，设计器主机与特定文件相关联。 当从项目中删除设计器宿主的源文件时，链接到设计器宿主的工具箱项将自动从工具箱中删除。

链接工具箱项可以实现一些方案，例如在打开Windows 窗体设计器时禁用 ASP.NET 工具箱项。

另请参阅

• IDesignerHost