ControlDesigner.EnableDesignMode(Control, String) Metodo

Definizione

Abilita la funzionalità della fase di progettazione per un controllo figlio.Enables design time functionality for a child control.

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

Parametri

child
Control

Controllo figlio per il quale viene abilitata la modalità di progettazione.The child control for which design mode will be enabled.

name
String

Nome del controllo child esposto all'utente finale.The name of child as exposed to the end user.

Restituisce

true se il controllo figlio può essere abilitato per la fase di progettazione; false se la infrastruttura host non supporta questa funzionalità.true if the child control could be enabled for design time; false if the hosting infrastructure does not support it.

Eccezioni

child o name è null.child or name is null.

Commenti

Il controllo figlio specificato da child è figlio del controllo della finestra di progettazione del controllo.The child control specified by child is a child of this control designer's control. L'elemento figlio non partecipa direttamente alla persistenza, ma verrà esposto come proprietà del controllo principale.The child does not directly participate in persistence, but it will if it is exposed as a property of the main control. Si consideri un controllo come il SplitContainer: sono presenti due pannelli, Panel1 e Panel2.Consider a control like the SplitContainer: it has two panels, Panel1 and Panel2. Questi pannelli vengono esposti tramite Panel1 di sola lettura e Panel2 proprietà nel controllo SplitContainer.These panels are exposed through read only Panel1 and Panel2 properties on the SplitContainer control. La finestra di progettazione del controllo SplitContainer chiama EnableDesignMode per ogni pannello, che consente l'eliminazione di altri componenti.The SplitContainer control's designer calls EnableDesignMode for each panel, which allows other components to be dropped on them. Tuttavia, per poter salvare il contenuto di Panel1 e Panel2, il controllo SplitContainer stesso deve esporre i pannelli come proprietà pubbliche.But, in order for the contents of Panel1 and Panel2 to be saved, the SplitContainer control itself must expose the panels as public properties.

I nomi dei controlli devono essere univoci all'interno di una finestra di progettazione del controllo, ma non devono essere univoci per quanto riguarda gli elementi figlio di altre finestre di progettazione controlli.Control names must be unique within a control designer, but they are not required to be unique with respect to the children of other control designers.

Per supportare questa funzionalità, l'infrastruttura host deve esporre la classe INestedContainer come servizio tramite il sito.To support this feature, the hosting infrastructure must expose the INestedContainer class as a service through the site.

Si applica a