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 .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.
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 .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.
