ToolboxService.CreateItemContainer Metoda

Definicja

Przestrzeń nazw:

System.Drawing.Design

Zestaw:

System.Drawing.Design.dll

Tworzy nowy kontener elementu przybornika na podstawie elementu przybornika lub zapisanego obiektu danych.

Przeciążenia

CreateItemContainer(IDataObject)	Tworzy nowy kontener elementu przybornika z zapisanego obiektu danych.
CreateItemContainer(ToolboxItem, IDesignerHost)	Tworzy nowy kontener elementów przybornika na podstawie elementu przybornika.

CreateItemContainer(IDataObject)

Tworzy nowy kontener elementu przybornika z zapisanego obiektu danych.

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

Obiekt danych zawierający zapisane dane przybornika.

Zwraca

ToolboxItemContainer

Nowy kontener elementu przybornika.

Wyjątki

ArgumentNullException

dataObject to null.

Uwagi

Metoda CreateItemContainer daje możliwość udostępnienia pochodnej wersji elementu ToolboxItemContainer. Domyślnie ToolboxService klasa nie obsługuje połączonych elementów, dlatego zwraca null parametry łącza, które nie nullsą . Aby zapewnić obsługę linków, należy zastąpić tę metodę, aby utworzyć pochodną ToolboxItemContainer , która może obsługiwać łącza.

Przekazany obiekt danych powinien zawierać dane uzyskane z wcześniejszego wywołania ToolboxItemContainer.ToolboxData właściwości w kontenerze elementu przybornika.

Uwagi dotyczące dziedziczenia

Połączony element przybornika jest elementem, którego istnienie jest powiązane z magazynem określonego hosta projektanta. Dlatego w typowym systemie projektu host projektanta jest skojarzony z określonym plikiem. Element przybornika połączony z hostem projektanta zostanie automatycznie usunięty z przybornika po usunięciu lub usunięciu pliku źródłowego hosta projektanta z projektu.

Połączone elementy przybornika umożliwiają takie scenariusze jak wyłączenie elementów przybornika ASP.NET po otwarciu projektanta Windows Forms.

CreateItemContainer(ToolboxItem, IDesignerHost)

Tworzy nowy kontener elementów przybornika na podstawie elementu przybornika.

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

Element przybornika, dla którego ma zostać utworzony kontener elementów.

link

IDesignerHost

Opcjonalny host projektanta, który powinien być połączony z tym elementem przybornika. Ten parametr może mieć wartość null.

Zwraca

ToolboxItemContainer

Nowy kontener elementu przybornika.

Wyjątki

ArgumentNullException

item to null.

Uwagi

Metoda CreateItemContainer daje możliwość udostępnienia pochodnej wersji elementu ToolboxItemContainer. Domyślnie ToolboxService klasa nie obsługuje połączonych elementów, dlatego zwraca null parametry łącza, które nie nullsą . Aby zapewnić obsługę linków, należy zastąpić tę metodę, aby utworzyć pochodną ToolboxItemContainer , która może obsługiwać łącza.

Jeśli podany IDesignerHost parametr linku jest przypisany, wskazuje, że jest to połączony element przybornika.

Uwagi dotyczące dziedziczenia

Połączony element przybornika jest elementem, którego istnienie jest powiązane z magazynem określonego hosta projektanta. Dlatego w typowym systemie projektu host projektanta jest skojarzony z określonym plikiem. Element przybornika połączony z hostem projektanta zostanie automatycznie usunięty z przybornika po usunięciu lub usunięciu pliku źródłowego hosta projektanta z projektu.

Połączone elementy przybornika umożliwiają takie scenariusze jak wyłączenie elementów przybornika ASP.NET po otwarciu projektanta Windows Forms.

Zobacz też

• IDesignerHost