ToolboxService.CreateItemContainer Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.ToolboxItemContainerProtected Overridable Function CreateItemContainer (dataObject As IDataObject) As ToolboxItemContainerParâmetros
- dataObject
- IDataObject
Um objeto de dados que contém dados de caixa de ferramentas salvos.
Retornos
Um novo contêiner de item de caixa de ferramentas.
Exceções
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.ToolboxItemContainerProtected Overridable Function CreateItemContainer (item As ToolboxItem, link As IDesignerHost) As ToolboxItemContainerParâ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
Um novo contêiner de item de caixa de ferramentas.
Exceções
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.
