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í

CreateItemContainer(IDataObject)	Vytvoří nový kontejner položek panelu 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 panelu 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á možnost poskytnout odvozenou verzi .ToolboxItemContainer Ve výchozím nastavení ToolboxService třída nepodporuje propojené položky, takže vrací null parametry propojení, které nejsou null. Chcete-li poskytnout podporu propojení, měli byste přepsat tuto metodu a vytvořit odvozenou ToolboxItemContainer , která je schopna zpracovat propojení.

Předaný datový objekt by měl obsahovat data získaná z předchozího volání ToolboxItemContainer.ToolboxData vlastnosti v kontejneru položek sady nástrojů.

Poznámky pro dědice

Propojená položka panelu nástrojů je ta, jejíž existence je vázána na úložiště konkrétního hostitele návrháře. V typickém systému projektu je tedy hostitel návrháře přidružený ke konkrétnímu souboru. Položka panelu nástrojů propojená s hostitelem návrháře se automaticky odstraní 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í ASP.NET položek panelu nástrojů, když je otevřený návrhář model 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á možnost poskytnout odvozenou verzi .ToolboxItemContainer Ve výchozím nastavení ToolboxService třída nepodporuje propojené položky, takže vrací null parametry propojení, které nejsou null. Chcete-li poskytnout podporu propojení, měli byste přepsat tuto metodu a vytvořit odvozenou ToolboxItemContainer , která je schopna zpracovat propojení.

Pokud je zadaný IDesignerHost parametr odkazu 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 vázána na úložiště konkrétního hostitele návrháře. V typickém systému projektu je tedy hostitel návrháře přidružený ke konkrétnímu souboru. Položka panelu nástrojů propojená s hostitelem návrháře se automaticky odstraní 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í ASP.NET položek panelu nástrojů, když je otevřený návrhář model Windows Forms.

Viz také

• IDesignerHost