ToolboxService.CreateItemContainer Methode

Definition

Namespace:

System.Drawing.Design

Assembly:

System.Drawing.Design.dll

Erstellt einen neuen Toolboxelementcontainer aus einem Toolboxelement oder einem gespeicherten Datenobjekt.

Überlädt

CreateItemContainer(IDataObject)	Erstellt einen neuen Toolboxelementcontainer aus einem gespeicherten Datenobjekt.
CreateItemContainer(ToolboxItem, IDesignerHost)	Erstellt einen neuen Toolboxelementcontainer aus einem Toolboxelement.

CreateItemContainer(IDataObject)

Erstellt einen neuen Toolboxelementcontainer aus einem gespeicherten Datenobjekt.

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

Parameter

dataObject

IDataObject

Ein Datenobjekt, das gespeicherte Toolboxdaten enthält.

Gibt zurück

ToolboxItemContainer

Ein neuer Toolboxelementcontainer.

Ausnahmen

ArgumentNullException

dataObject ist null

Hinweise

Die CreateItemContainer -Methode gibt Ihnen die Möglichkeit, eine abgeleitete Version von bereitzustellen ToolboxItemContainer. Standardmäßig unterstützt die ToolboxService -Klasse keine verknüpften Elemente. Daher gibt sie für Linkparameter zurück null , die nicht nullsind. Um Linkunterstützung bereitzustellen, sollten Sie diese Methode überschreiben, um eine abgeleitete ToolboxItemContainer Methode zu erstellen, die Links verarbeiten kann.

Das übergebene Datenobjekt sollte Daten enthalten, die von einem vorherigen Aufruf der ToolboxItemContainer.ToolboxData -Eigenschaft in einem Toolboxelementcontainer abgerufen wurden.

Hinweise für Vererber

Ein verknüpftes Toolboxelement ist ein Element, dessen Existenz an die Speicherung eines bestimmten Designerhosts gebunden ist. In einem typischen Projektsystem ist also ein Designerhost einer bestimmten Datei zugeordnet. Ein Toolboxelement, das mit einem Designerhost verknüpft ist, wird automatisch aus der Toolbox gelöscht, wenn die Quelldatei des Designerhosts gelöscht oder aus dem Projekt entfernt wird.

Verknüpfte Toolboxelemente ermöglichen Szenarien wie das Deaktivieren der ASP.NET Toolboxelemente, wenn der Windows Forms-Designer geöffnet ist.

CreateItemContainer(ToolboxItem, IDesignerHost)

Erstellt einen neuen Toolboxelementcontainer aus einem Toolboxelement.

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

Parameter

item

ToolboxItem

Das Toolboxelement, für das ein Elementcontainer erstellt werden soll.

link

IDesignerHost

Ein optionaler Designerhost, der mit diesem Toolboxelement verknüpft werden soll. Dieser Parameter kann null sein.

Gibt zurück

ToolboxItemContainer

Ein neuer Toolboxelementcontainer.

Ausnahmen

ArgumentNullException

item ist null

Hinweise

Die CreateItemContainer -Methode gibt Ihnen die Möglichkeit, eine abgeleitete Version von bereitzustellen ToolboxItemContainer. Standardmäßig unterstützt die ToolboxService -Klasse keine verknüpften Elemente. Daher gibt sie für Linkparameter zurück null , die nicht nullsind. Um Linkunterstützung bereitzustellen, sollten Sie diese Methode überschreiben, um eine abgeleitete ToolboxItemContainer Methode zu erstellen, die Links verarbeiten kann.

Wenn der angegebene IDesignerHost Linkparameter zugewiesen ist, gibt dies an, dass es sich um ein verknüpftes Toolboxelement handelt.

Hinweise für Vererber

Ein verknüpftes Toolboxelement ist ein Element, dessen Existenz an die Speicherung eines bestimmten Designerhosts gebunden ist. In einem typischen Projektsystem ist also ein Designerhost einer bestimmten Datei zugeordnet. Ein Toolboxelement, das mit einem Designerhost verknüpft ist, wird automatisch aus der Toolbox gelöscht, wenn die Quelldatei des Designerhosts gelöscht oder aus dem Projekt entfernt wird.

Verknüpfte Toolboxelemente ermöglichen Szenarien wie das Deaktivieren der ASP.NET Toolboxelemente, wenn der Windows Forms-Designer geöffnet ist.

Weitere Informationen

• IDesignerHost