ControlDesigner.EnableDesignMode(Control, String) Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms.Design

Zestaw:

System.Design.dll

Zestaw:

System.Windows.Forms.Design.dll

Włącza funkcję czasu projektowania dla kontrolki podrzędnej.

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

Parametry

child

Control

Kontrolka podrzędna, dla której zostanie włączony tryb projektowania.

name

String

Nazwa widoczna child dla użytkownika końcowego.

Zwraca

Boolean

true jeśli kontrolka podrzędna może być włączona na czas projektowania; false jeśli infrastruktura hostingu nie obsługuje tej infrastruktury.

Wyjątki

ArgumentNullException

child lub name ma wartość null.

Uwagi

Kontrolka podrzędna określona przez child program jest elementem podrzędnym kontrolki tego projektanta kontrolek. Element podrzędny nie uczestniczy bezpośrednio w trwałości, ale jeśli zostanie uwidoczniony jako właściwość głównej kontrolki. Rozważ kontrolkę podobną do SplitContainer: ma dwa panele i Panel2``Panel1 . Te panele są widoczne tylko do odczytu Panel1 i Panel2 właściwości w kontrolce SplitContainer . Projektant SplitContainer kontrolki wywołuje wywołanie EnableDesignMode każdego panelu, co umożliwia usunięcie na nich innych składników. Jednak w celu zapisania zawartości i Panel1 Panel2 zapisania sama kontrolka SplitContainer musi uwidocznić panele jako właściwości publiczne.

Nazwy kontrolek muszą być unikatowe w projektancie kontrolek, ale nie muszą być unikatowe w odniesieniu do elementów podrzędnych innych projektantów kontrolek.

Aby obsługiwać tę funkcję, infrastruktura hostingu musi uwidocznić INestedContainer klasę jako usługę za pośrednictwem lokacji.