ToolboxService.CreateItemContainer Méthode

Définition

Espace de noms:

System.Drawing.Design

Assembly:

System.Drawing.Design.dll

Crée un nouveau conteneur d'éléments de boîte à outils à partir d'un élément de boîte à outils ou d'un objet de données enregistré.

Surcharges

CreateItemContainer(IDataObject)	Crée un nouveau conteneur d'éléments de boîte à outils à partir d'un objet de données enregistré.
CreateItemContainer(ToolboxItem, IDesignerHost)	Crée un nouveau conteneur d'éléments de boîte à outils à partir d'un élément de boîte à outils.

CreateItemContainer(IDataObject)

Crée un nouveau conteneur d'éléments de boîte à outils à partir d'un objet de données enregistré.

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

Paramètres

dataObject

IDataObject

Objet de données qui contient des données de boîte à outils enregistrées.

Retours

ToolboxItemContainer

Nouveau conteneur d'éléments de boîte à outils.

Exceptions

ArgumentNullException

dataObject a la valeur null.

Remarques

La CreateItemContainer méthode vous donne la possibilité de fournir une version dérivée d’un ToolboxItemContainer. Par défaut, la ToolboxService classe ne prend pas en charge les éléments liés. Elle retourne null donc pour les paramètres de lien qui ne sont pas null. Pour assurer la prise en charge des liens, vous devez remplacer cette méthode pour créer un dérivé ToolboxItemContainer capable de gérer les liens.

L’objet de données transmis doit contenir des données obtenues à partir d’un appel antérieur à la ToolboxItemContainer.ToolboxData propriété sur un conteneur d’éléments de boîte à outils.

Notes pour les héritiers

Un élément de boîte à outils lié est un élément dont l’existence est liée au stockage d’un hôte de concepteur particulier. Ainsi, dans un système de projet classique, un hôte de concepteur est associé à un fichier particulier. Un élément de boîte à outils lié à un hôte de concepteur est automatiquement supprimé de la boîte à outils lorsque le fichier source de l’hôte du concepteur est supprimé ou supprimé du projet.

Les éléments de boîte à outils liés rendent possibles des scénarios tels que la désactivation de l’ASP.NET éléments de boîte à outils lorsque le concepteur Windows Forms est ouvert.

CreateItemContainer(ToolboxItem, IDesignerHost)

Crée un nouveau conteneur d'éléments de boîte à outils à partir d'un élément de boîte à outils.

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

Paramètres

item

ToolboxItem

Élément de boîte à outils pour lequel un conteneur d'éléments doit être créé.

link

IDesignerHost

Hôte de concepteur facultatif qui doit être lié à cet élément de boîte à outils. Ce paramètre peut être null.

Retours

ToolboxItemContainer

Nouveau conteneur d'éléments de boîte à outils.

Exceptions

ArgumentNullException

item a la valeur null.

Remarques

La CreateItemContainer méthode vous donne la possibilité de fournir une version dérivée d’un ToolboxItemContainer. Par défaut, la ToolboxService classe ne prend pas en charge les éléments liés. Elle retourne null donc pour les paramètres de lien qui ne sont pas null. Pour assurer la prise en charge des liens, vous devez remplacer cette méthode pour créer un dérivé ToolboxItemContainer capable de gérer les liens.

Si le paramètre de lien fourni IDesignerHost est affecté, cela indique qu’il s’agit d’un élément de boîte à outils lié.

Notes pour les héritiers

Un élément de boîte à outils lié est un élément dont l’existence est liée au stockage d’un hôte de concepteur particulier. Ainsi, dans un système de projet classique, un hôte de concepteur est associé à un fichier particulier. Un élément de boîte à outils lié à un hôte de concepteur est automatiquement supprimé de la boîte à outils lorsque le fichier source de l’hôte du concepteur est supprimé ou supprimé du projet.

Les éléments de boîte à outils liés rendent possibles des scénarios tels que la désactivation de l’ASP.NET éléments de boîte à outils lorsque le concepteur Windows Forms est ouvert.

Voir aussi

• IDesignerHost