ControlDesigner.EnableDesignMode(Control, String) Methode

  • Referenz

Definition

Namespace:
System.Windows.Forms.Design
Assembly:
System.Design.dll
Assembly:
System.Windows.Forms.Design.dll

Aktiviert die 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 des child, wie dieser dem Endbenutzer verfügbar gemacht wird.

Gibt zurück

Boolean

true, wenn das untergeordnete Steuerelement für die Entwurfszeit aktiviert werden konnte, false, wenn die als Host fungierende Infrastruktur es nicht unterstützt.

Ausnahmen

ArgumentNullException

child oder name ist null.

Hinweise

Das von child angegebene untergeordnete Steuerelement ist ein untergeordnetes Element des Steuerelement-Designers. Das untergeordnete Element ist nicht direkt an persistenz beteiligt, aber es wird ausgeführt, wenn es als Eigenschaft des Hauptsteuerelements verfügbar gemacht wird. Betrachten Sie ein Steuerelement wie das SplitContainer: es verfügt über zwei Bereiche, Panel1 und Panel2. Diese Bereiche werden über schreibgeschützte Panel1 Eigenschaften und Panel2 eigenschaften des Steuerelements SplitContainer verfügbar gemacht. Der SplitContainer Designer des Steuerelements ruft EnableDesignMode für jeden Bereich auf, wodurch andere Komponenten auf ihnen abgelegt werden können. Damit jedoch der Inhalt von Panel1 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, aber sie müssen in Bezug auf die untergeordneten Elemente anderer Steuerelementdesigner nicht 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: