ToolboxService.CreateItemContainer Método

Definición

Espacio de nombres:

System.Drawing.Design

Ensamblado:

System.Drawing.Design.dll

Crea un nuevo contenedor de elementos del cuadro de herramientas a partir de un elemento del cuadro de herramientas o un objeto de datos guardado.

Sobrecargas

CreateItemContainer(IDataObject)	Crea un nuevo contenedor de elementos de cuadro de herramientas a partir de un objeto de datos guardado.
CreateItemContainer(ToolboxItem, IDesignerHost)	Crea un nuevo contenedor de elementos del cuadro de herramientas a partir de un elemento del cuadro de herramientas.

CreateItemContainer(IDataObject)

Crea un nuevo contenedor de elementos de cuadro de herramientas a partir de un objeto de datos guardado.

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

Parámetros

dataObject

IDataObject

Un objeto de datos que contiene los datos guardados del cuadro de herramientas.

Devoluciones

ToolboxItemContainer

Un nuevo contenedor de elementos del cuadro de herramientas.

Excepciones

ArgumentNullException

dataObject es null.

Comentarios

El CreateItemContainer método ofrece la oportunidad de proporcionar una versión derivada de .ToolboxItemContainer De forma predeterminada, la ToolboxService clase no admite elementos vinculados, por lo que devuelve null para los parámetros de vínculo que no nullson . Para proporcionar compatibilidad con vínculos, debe invalidar este método para crear un derivado ToolboxItemContainer capaz de controlar vínculos.

El objeto de datos pasado debe contener datos obtenidos de una llamada anterior a la ToolboxItemContainer.ToolboxData propiedad en un contenedor de elementos del cuadro de herramientas.

Notas a los desarrolladores de herederos

Un elemento del cuadro de herramientas vinculado es aquel cuya existencia está vinculada al almacenamiento de un host de diseñador determinado. Por lo tanto, en un sistema de proyecto típico, un host de diseñador está asociado a un archivo determinado. Un elemento del cuadro de herramientas vinculado a un host de diseñador se eliminaría automáticamente del cuadro de herramientas cuando el archivo de origen del host del diseñador se elimina o quita del proyecto.

Los elementos del cuadro de herramientas vinculados hacen posibles escenarios como deshabilitar los elementos del cuadro de herramientas de ASP.NET cuando el diseñador de Windows Forms está abierto.

CreateItemContainer(ToolboxItem, IDesignerHost)

Crea un nuevo contenedor de elementos del cuadro de herramientas a partir de un elemento del cuadro de herramientas.

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

Parámetros

item

ToolboxItem

Elemento del cuadro de herramientas para el que se va a crear un contenedor de elementos.

link

IDesignerHost

Host de diseñador opcional que debe vincularse a este elemento del cuadro de herramientas. Este parámetro puede ser null.

Devoluciones

ToolboxItemContainer

Un nuevo contenedor de elementos del cuadro de herramientas.

Excepciones

ArgumentNullException

item es null.

Comentarios

El CreateItemContainer método ofrece la oportunidad de proporcionar una versión derivada de .ToolboxItemContainer De forma predeterminada, la ToolboxService clase no admite elementos vinculados, por lo que devuelve null para los parámetros de vínculo que no nullson . Para proporcionar compatibilidad con vínculos, debe invalidar este método para crear un derivado ToolboxItemContainer capaz de controlar vínculos.

Si se asigna el parámetro de vínculo proporcionado IDesignerHost , indica que se trata de un elemento del cuadro de herramientas vinculado.

Notas a los desarrolladores de herederos

Un elemento del cuadro de herramientas vinculado es aquel cuya existencia está vinculada al almacenamiento de un host de diseñador determinado. Por lo tanto, en un sistema de proyecto típico, un host de diseñador está asociado a un archivo determinado. Un elemento del cuadro de herramientas vinculado a un host de diseñador se eliminaría automáticamente del cuadro de herramientas cuando el archivo de origen del host del diseñador se elimina o quita del proyecto.

Los elementos del cuadro de herramientas vinculados hacen posibles escenarios como deshabilitar los elementos del cuadro de herramientas de ASP.NET cuando el diseñador de Windows Forms está abierto.

Consulte también

• IDesignerHost