ToolboxService.CreateItemContainer Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
Nouveau conteneur d'éléments de boîte à outils.
Exceptions
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.
S’applique à
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
Nouveau conteneur d'éléments de boîte à outils.
Exceptions
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.