ToolboxService.CreateItemContainer Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
Nowy kontener elementu przybornika.
Wyjątki
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.
Dotyczy
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
Nowy kontener elementu przybornika.
Wyjątki
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.