ToolboxService.CreateItemContainer Método

Definição

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.

Ver também

Aplica-se a