Compartilhar via

ToolboxService.CreateItemContainer Método

  • Referência

Definição

Namespace:
System.Drawing.Design
Assembly:
System.Drawing.Design.dll

Cria um novo contêiner de item de caixa de ferramentas de um item de caixa de ferramentas ou um objeto de dados salvo.

Sobrecargas

CreateItemContainer(IDataObject)

Cria um novo contêiner de item de caixa de ferramentas de um objeto de dados salvo.
CreateItemContainer(ToolboxItem, IDesignerHost)

Cria um novo contêiner de item de caixa de ferramentas de um item de caixa de ferramentas.

CreateItemContainer(IDataObject)

Cria um novo contêiner de item de caixa de ferramentas de um objeto de dados salvo.

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 de caixa de ferramentas salvos.

Retornos

ToolboxItemContainer

Um novo contêiner de item de caixa de ferramentas.

Exceções

ArgumentNullException

dataObject é null.

Comentários

O CreateItemContainer método oferece a oportunidade de fornecer uma versão derivada de um ToolboxItemContainer. Por padrão, a ToolboxService classe não dá suporte a itens vinculados, portanto, retorna null para parâmetros de link que não nullsão . Para fornecer suporte a link, você deve substituir esse 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 para a ToolboxItemContainer.ToolboxData propriedade em um contêiner de item de caixa de ferramentas.

Notas aos Herdeiros

Um item de caixa de ferramentas vinculado é aquele cuja existência está vinculada ao armazenamento de um host de designer específico. Portanto, em um sistema de projeto típico, um host de designer é associado a um arquivo específico. Um item de caixa de ferramentas vinculado a um host de designer seria excluído automaticamente da caixa de ferramentas quando o arquivo de origem do host do designer fosse excluído ou removido do projeto.

Os itens da caixa de ferramentas vinculados tornam possíveis cenários, como desabilitar os itens da caixa de ferramentas ASP.NET quando o designer de Windows Forms estiver aberto.

Aplica-se a

CreateItemContainer(ToolboxItem, IDesignerHost)

Cria um novo contêiner de item de caixa de ferramentas de um item de 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 de caixa de ferramentas para a qual criar um contêiner de item.

link
IDesignerHost

Um host de designer opcional que deve ser vinculado a este item de caixa de ferramentas. Esse parâmetro pode ser null.

Retornos

ToolboxItemContainer

Um novo contêiner de item de caixa de ferramentas.

Exceções

ArgumentNullException

item é null.

Comentários

O CreateItemContainer método oferece a oportunidade de fornecer uma versão derivada de um ToolboxItemContainer. Por padrão, a ToolboxService classe não dá suporte a itens vinculados, portanto, retorna null para parâmetros de link que não nullsão . Para fornecer suporte a link, você deve substituir esse método para criar um derivado ToolboxItemContainer capaz de lidar com links.

Se o parâmetro de link fornecido IDesignerHost for atribuído, ele indicará que esse é um item de caixa de ferramentas vinculado.

Notas aos Herdeiros

Um item de caixa de ferramentas vinculado é aquele cuja existência está vinculada ao armazenamento de um host de designer específico. Portanto, em um sistema de projeto típico, um host de designer é associado a um arquivo específico. Um item de caixa de ferramentas vinculado a um host de designer seria excluído automaticamente da caixa de ferramentas quando o arquivo de origem do host do designer fosse excluído ou removido do projeto.

Os itens da caixa de ferramentas vinculados tornam possíveis cenários, como desabilitar os itens da caixa de ferramentas ASP.NET quando o designer de Windows Forms estiver aberto.

Confira também

Aplica-se a