ToolboxService.CreateItemContainer Metoda

Definice

Obor názvů:

System.Drawing.Design

Sestavení:

System.Drawing.Design.dll

Vytvoří nový kontejner položek panelu nástrojů z položky panelu nástrojů nebo uloženého datového objektu.

Přetížení

Name	Description
CreateItemContainer(IDataObject)	Vytvoří nový kontejner položek sady nástrojů z uloženého datového objektu.
CreateItemContainer(ToolboxItem, IDesignerHost)	Vytvoří nový kontejner položek panelu nástrojů z položky panelu nástrojů.

CreateItemContainer(IDataObject)

Vytvoří nový kontejner položek sady nástrojů z uloženého datového objektu.

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

Parametry

dataObject

IDataObject

Datový objekt obsahující uložená data panelu nástrojů.

Návraty

ToolboxItemContainer

Nový kontejner položek panelu nástrojů

Výjimky

ArgumentNullException

dataObject je null.

Poznámky

Metoda CreateItemContainer vám dává příležitost poskytnout odvozenou verzi ToolboxItemContainer. Ve výchozím nastavení ToolboxService třída nepodporuje propojené položky, takže se vrátí null pro parametry propojení, které nejsou null. Pokud chcete poskytnout podporu propojení, měli byste tuto metodu přepsat a vytvořit odvozený ToolboxItemContainer , který dokáže zpracovat odkazy.

Datový objekt předaný by měl obsahovat data získaná před voláním ToolboxItemContainer.ToolboxData vlastnosti v kontejneru položek panelu nástrojů.

Poznámky pro dědice

Propojená položka panelu nástrojů je ta, jejíž existence je svázaná s úložištěm konkrétního hostitele návrháře. V typickém projektovém systému je tedy hostitel návrháře přidružený k určitému souboru. Položka sady nástrojů propojená s hostitelem návrháře by se automaticky odstranila z panelu nástrojů při odstranění nebo odebrání zdrojového souboru hostitele návrháře z projektu.

Propojené položky panelu nástrojů umožňují scénáře, jako je zakázání položek panelu nástrojů ASP.NET při otevření návrháře Windows Forms.

CreateItemContainer(ToolboxItem, IDesignerHost)

Vytvoří nový kontejner položek panelu nástrojů z položky panelu nástrojů.

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

Parametry

item

ToolboxItem

Položka panelu nástrojů, pro kterou chcete vytvořit kontejner položek.

link

IDesignerHost

Volitelný hostitel návrháře, který by měl být propojený s touto položkou panelu nástrojů. Tento parametr může být null.

Návraty

ToolboxItemContainer

Nový kontejner položek panelu nástrojů

Výjimky

ArgumentNullException

item je null.

Poznámky

Metoda CreateItemContainer vám dává příležitost poskytnout odvozenou verzi ToolboxItemContainer. Ve výchozím nastavení ToolboxService třída nepodporuje propojené položky, takže se vrátí null pro parametry propojení, které nejsou null. Pokud chcete poskytnout podporu propojení, měli byste tuto metodu přepsat a vytvořit odvozený ToolboxItemContainer , který dokáže zpracovat odkazy.

Pokud je zadaný IDesignerHost parametr propojení přiřazený, znamená to, že se jedná o propojenou položku panelu nástrojů.

Poznámky pro dědice

Propojená položka panelu nástrojů je ta, jejíž existence je svázaná s úložištěm konkrétního hostitele návrháře. V typickém projektovém systému je tedy hostitel návrháře přidružený k určitému souboru. Položka sady nástrojů propojená s hostitelem návrháře by se automaticky odstranila z panelu nástrojů při odstranění nebo odebrání zdrojového souboru hostitele návrháře z projektu.

Propojené položky panelu nástrojů umožňují scénáře, jako je zakázání položek panelu nástrojů ASP.NET při otevření návrháře Windows Forms.

Viz také

• IDesignerHost