ControlDesigner.EnableDesignMode(Control, String) Méthode

Définition

Espace de noms:

System.Windows.Forms.Design

Assembly:

System.Windows.Forms.Design.dll

Active les fonctionnalités de design pour un contrôle enfant.

protected:
 bool EnableDesignMode(System::Windows::Forms::Control ^ child, System::String ^ name);

protected bool EnableDesignMode (System.Windows.Forms.Control child, string name);

member this.EnableDesignMode : System.Windows.Forms.Control * string -> bool

Protected Function EnableDesignMode (child As Control, name As String) As Boolean

Paramètres

child

Control

Le contrôle enfant pour lequel le mode Design sera activé.

name

String

Le nom de child tel qu'il est exposé à l'utilisateur final.

Retours

Boolean

true si le contrôle enfant a pu être activé pour le design ; false si l'infrastructure d'hébergement ne le prend pas en charge.

Exceptions

ArgumentNullException

child ou name est null.

Remarques

Le contrôle enfant spécifié par child est un enfant du contrôle de ce concepteur de contrôles. L’enfant ne participe pas directement à la persistance, mais il le fera s’il est exposé en tant que propriété du contrôle principal. Considérez un contrôle comme : SplitContaineril a deux panneaux, Panel1 et Panel2. Ces panneaux sont exposés via des propriétés et Panel2 en lecture seule Panel1 sur le SplitContainer contrôle. Le SplitContainer concepteur du contrôle appelle EnableDesignMode pour chaque panneau, ce qui permet de supprimer d’autres composants. Toutefois, pour que le contenu de Panel1 et Panel2 soit enregistré, le SplitContainer contrôle lui-même doit exposer les panneaux en tant que propriétés publiques.

Les noms de contrôle doivent être uniques au sein d’un concepteur de contrôles, mais ils ne doivent pas nécessairement être uniques par rapport aux enfants d’autres concepteurs de contrôles.

Pour prendre en charge cette fonctionnalité, l’infrastructure d’hébergement doit exposer la INestedContainer classe en tant que service via le site.