ControlDesigner.EnableDesignMode(Control, String) Methode

Definition

Aktiviert Entwurfszeitfunktionen für ein untergeordnetes Steuerelement.

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

Parameter

child
Control

Das untergeordnete Steuerelement, für das der Entwurfsmodus aktiviert wird.

name
String

Der Name, der child für den Endbenutzer verfügbar gemacht wird.

Gibt zurück

true wenn das untergeordnete Steuerelement zur Entwurfszeit aktiviert werden kann; false wenn die Hostinginfrastruktur sie nicht unterstützt.

Ausnahmen

child oder name ist null.

Hinweise

Das durch child dieses Steuerelement angegebene untergeordnete Steuerelement ist ein untergeordnetes Element des Steuerelement-Designers. Das Kind nimmt nicht direkt an Persistenz teil, sondern wird, wenn es als Eigenschaft des Hauptsteuerelements verfügbar gemacht wird. Betrachten Sie ein Steuerelement wie das SplitContainer: es verfügt über zwei Bereiche und Panel1Panel2. Diese Panels werden über schreibgeschützte Panel1 Und Panel2 Eigenschaften für das SplitContainer Steuerelement verfügbar gemacht. Der SplitContainer Designer des Steuerelements ruft für jedes Panel auf EnableDesignMode , wodurch andere Komponenten gelöscht werden können. Damit der Inhalt jedoch Panel1 gespeichert und Panel2 gespeichert werden kann, muss das SplitContainer Steuerelement selbst die Panels als öffentliche Eigenschaften verfügbar machen.

Steuerelementnamen müssen innerhalb eines Steuerelement-Designers eindeutig sein, müssen jedoch nicht in Bezug auf die untergeordneten Elemente anderer Steuerelementdesigner eindeutig sein.

Um dieses Feature zu unterstützen, muss die Hostinginfrastruktur die INestedContainer Klasse als Dienst über den Standort verfügbar machen.

Gilt für: