ToolboxService.CreateItemContainer 方法

定義

命名空間:

System.Drawing.Design

組件:

System.Drawing.Design.dll

從工具箱項目或儲存的資料物件建立新的工具箱項目容器。

多載

CreateItemContainer(IDataObject)	從儲存的資料物件建立新的工具箱項目容器。
CreateItemContainer(ToolboxItem, IDesignerHost)	從工具箱項目建立新的工具箱項目容器。

CreateItemContainer(IDataObject)

從儲存的資料物件建立新的工具箱項目容器。

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

參數

dataObject

IDataObject

資料物件，包含儲存的工具箱資料。

傳回

ToolboxItemContainer

新的工具箱項目容器。

例外狀況

ArgumentNullException

dataObject 為 null。

備註

方法 CreateItemContainer 可讓您有機會提供的衍生版本 ToolboxItemContainer。 根據預設，類別ToolboxService不支援連結專案，因此會針對不是null的連結參數傳回 null 。 若要提供連結支援，您應該覆寫這個方法，以建立能夠處理連結的衍生 ToolboxItemContainer 專案。

傳入的數據物件應該包含從在工具箱專案容器上呼叫 ToolboxItemContainer.ToolboxData 屬性之前取得的數據。

給繼承者的注意事項

連結的工具箱專案是其中一個專案，其存在會系結至特定設計工具主機的記憶體。 因此，在一般項目系統中，設計工具主機會與特定檔案相關聯。 當設計工具主機的來源檔案遭到刪除或從專案移除時，連結至設計工具主機的工具箱專案會自動從工具箱中刪除。

連結的工具箱專案可以在開啟 Windows Forms 設計工具時停用 ASP.NET 工具箱專案等案例。

CreateItemContainer(ToolboxItem, IDesignerHost)

從工具箱項目建立新的工具箱項目容器。

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

參數

item

ToolboxItem

要建立項目容器的工具箱項目。

link

IDesignerHost

應連結至這個工具箱項目的選擇性設計工具主應用程式。 這個參數可以是 null。

傳回

ToolboxItemContainer

新的工具箱項目容器。

例外狀況

ArgumentNullException

item 為 null。

備註

方法 CreateItemContainer 可讓您有機會提供的衍生版本 ToolboxItemContainer。 根據預設，類別ToolboxService不支援連結專案，因此會針對不是null的連結參數傳回 null 。 若要提供連結支援，您應該覆寫這個方法，以建立能夠處理連結的衍生 ToolboxItemContainer 專案。

如果已指派提供的 IDesignerHost 連結參數，表示這是連結的工具箱專案。

給繼承者的注意事項

連結的工具箱專案是其中一個專案，其存在會系結至特定設計工具主機的記憶體。 因此，在一般項目系統中，設計工具主機會與特定檔案相關聯。 當設計工具主機的來源檔案遭到刪除或從專案移除時，連結至設計工具主機的工具箱專案會自動從工具箱中刪除。

連結的工具箱專案可以在開啟 Windows Forms 設計工具時停用 ASP.NET 工具箱專案等案例。

另請參閱

• IDesignerHost