ToolboxService.CreateItemContainer Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Cria um novo contentor de itens toolbox a partir de um item toolbox ou de um objeto de dados guardados.
Sobrecargas
| Name | Description |
|---|---|
| CreateItemContainer(IDataObject) |
Cria um novo contentor de itens toolbox a partir de um objeto de dados guardado. |
| CreateItemContainer(ToolboxItem, IDesignerHost) |
Cria um novo contentor de itens da caixa de ferramentas a partir de um item da caixa de ferramentas. |
CreateItemContainer(IDataObject)
Cria um novo contentor de itens toolbox a partir de um objeto de dados 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
Um objeto de dados que contém dados guardados da caixa de ferramentas.
Devoluções
Uma nova caixa de ferramentas, contentor de objetos.
Exceções
dataObject é null.
Observações
O CreateItemContainer método dá-lhe a oportunidade de fornecer uma versão derivada de um ToolboxItemContainer. Por defeito, a ToolboxService classe não suporta itens ligados, por isso devolve null parâmetros de ligação que não nullsão . Para fornecer suporte de links, deve sobrepor este método para criar um derivado ToolboxItemContainer capaz de lidar com links.
O objeto de dados passado deve conter dados obtidos de uma chamada anterior à ToolboxItemContainer.ToolboxData propriedade num contentor de itens da toolbox.
Notas para Herdeiros
Um item de caixa de ferramentas ligado é aquele cuja existência está ligada ao armazenamento de um determinado hospedeiro designer. Assim, num sistema típico de projeto, um host designer está associado a um ficheiro específico. Um item da toolbox ligado a um host designer seria automaticamente eliminado da toolbox quando o ficheiro fonte do host designer fosse eliminado ou removido do projeto.
Itens ligados da caixa de ferramentas tornam possíveis cenários, como desativar os itens da caixa de ferramentas ASP.NET quando o designer do Windows Forms está aberto.
Aplica-se a
CreateItemContainer(ToolboxItem, IDesignerHost)
Cria um novo contentor de itens da caixa de ferramentas a partir de um item da caixa de ferramentas.
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
O item da caixa de ferramentas para criar um contentor de itens.
- link
- IDesignerHost
Um hospedeiro designer opcional que deve estar ligado a este item da caixa de ferramentas. Este parâmetro pode ser null.
Devoluções
Uma nova caixa de ferramentas, contentor de objetos.
Exceções
item é null.
Observações
O CreateItemContainer método dá-lhe a oportunidade de fornecer uma versão derivada de um ToolboxItemContainer. Por defeito, a ToolboxService classe não suporta itens ligados, por isso devolve null parâmetros de ligação que não nullsão . Para fornecer suporte de links, deve sobrepor este método para criar um derivado ToolboxItemContainer capaz de lidar com links.
Se o parâmetro de ligação fornecido IDesignerHost for atribuído, indica que este é um item de caixa de ferramentas ligado.
Notas para Herdeiros
Um item de caixa de ferramentas ligado é aquele cuja existência está ligada ao armazenamento de um determinado hospedeiro designer. Assim, num sistema típico de projeto, um host designer está associado a um ficheiro específico. Um item da toolbox ligado a um host designer seria automaticamente eliminado da toolbox quando o ficheiro fonte do host designer fosse eliminado ou removido do projeto.
Itens ligados da caixa de ferramentas tornam possíveis cenários, como desativar os itens da caixa de ferramentas ASP.NET quando o designer do Windows Forms está aberto.