ToolboxService.CreateItemContainer Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.ToolboxItemContainerProtected Overridable Function CreateItemContainer (dataObject As IDataObject) As ToolboxItemContainerParámetros
- dataObject
- IDataObject
Un objeto de datos que contiene los datos guardados del cuadro de herramientas.
Devoluciones
Un nuevo contenedor de elementos del cuadro de herramientas.
Excepciones
dataObject es null.
Comentarios
El CreateItemContainer método ofrece la oportunidad de proporcionar una versión derivada de un 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 son null . Para proporcionar compatibilidad con vínculos, debe invalidar este método para crear un derivado ToolboxItemContainer que sea capaz de controlar los vínculos.
El objeto de datos que se pasa debe contener datos obtenidos de una llamada anterior a la ToolboxItemContainer.ToolboxData propiedad de un contenedor de elementos del cuadro de herramientas.
Notas a los desarrolladores de herederos
Un elemento del cuadro de herramientas vinculado es aquél cuya existencia está ligada al almacenamiento de un host del diseñador determinado. Por lo tanto, en un sistema de proyectos típico, un host del diseñador está asociado a un archivo determinado. Un elemento del cuadro de herramientas vinculado a un host del diseñador se eliminará automáticamente del cuadro de herramientas cuando se elimine o se quite del proyecto el archivo de código fuente del host del diseñador.
Los elementos del cuadro de herramientas vinculados realizan posibles escenarios, como deshabilitar los elementos del cuadro de herramientas de ASP.NET cuando el diseñador de Windows Forms está abierto.
Se aplica a
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.ToolboxItemContainerProtected Overridable Function CreateItemContainer (item As ToolboxItem, link As IDesignerHost) As ToolboxItemContainerPará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
Un nuevo contenedor de elementos del cuadro de herramientas.
Excepciones
item es null.
Comentarios
El CreateItemContainer método ofrece la oportunidad de proporcionar una versión derivada de un 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 son null . Para proporcionar compatibilidad con vínculos, debe invalidar este método para crear un derivado ToolboxItemContainer que sea capaz de controlar los vínculos.
Si IDesignerHost se asigna el parámetro de vínculo proporcionado, 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 aquél cuya existencia está ligada al almacenamiento de un host del diseñador determinado. Por lo tanto, en un sistema de proyectos típico, un host del diseñador está asociado a un archivo determinado. Un elemento del cuadro de herramientas vinculado a un host del diseñador se eliminará automáticamente del cuadro de herramientas cuando se elimine o se quite del proyecto el archivo de código fuente del host del diseñador.
Los elementos del cuadro de herramientas vinculados realizan posibles escenarios, como deshabilitar los elementos del cuadro de herramientas de ASP.NET cuando el diseñador de Windows Forms está abierto.