ControlDesigner.EnableDesignMode(Control, String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
true
, wenn das untergeordnete Steuerelement für die Entwurfszeit aktiviert werden konnte, false
, wenn die als Host fungierende Infrastruktur es nicht unterstützt.
Ausnahmen
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.