DesignSurface.CreateDesigner(IComponent, Boolean) Methode

Definition

Namespace:

System.ComponentModel.Design

Assembly:

System.Windows.Forms.Design.dll

Erstellt einen Designer, wenn dem Container eine Komponente hinzugefügt wird.

protected public:
 virtual System::ComponentModel::Design::IDesigner ^ CreateDesigner(System::ComponentModel::IComponent ^ component, bool rootDesigner);

protected internal virtual System.ComponentModel.Design.IDesigner? CreateDesigner (System.ComponentModel.IComponent component, bool rootDesigner);

abstract member CreateDesigner : System.ComponentModel.IComponent * bool -> System.ComponentModel.Design.IDesigner
override this.CreateDesigner : System.ComponentModel.IComponent * bool -> System.ComponentModel.Design.IDesigner

Protected Friend Overridable Function CreateDesigner (component As IComponent, rootDesigner As Boolean) As IDesigner

Parameter

component

IComponent

Die Komponente, für die der Designer erstellt werden soll.

rootDesigner

Boolean

true, um einen Stammdesigner zu erstellen, false, um einen normalen Designer zu erstellen.

Gibt zurück

IDesigner

Eine Instanz des angeforderten Designers oder null, wenn kein entsprechender Designer gefunden werden kann.

Ausnahmen

ArgumentNullException

component ist null.

ObjectDisposedException

Das an das DesignSurface-Objekt angefügte IDesignerHost-Objekt wurde verworfen.

Hinweise

Die CreateDesigner -Methode wird von der Entwurfsoberfläche IContainer aufgerufen, wenn dem Container eine Komponente hinzugefügt wird. Diese Methode erstellt einen Designer, initialisiert ihn jedoch nicht. Wenn er zurückgibt, wird der Designer vom Container initialisiert.

CreateDesigner kann zwei verschiedene Arten von Designern erstellen: Stammdesigner und normale Designer. Ein Stamm-Designer ist ein Designer für die Stammkomponente in der Entwurfsoberfläche, die per Definition die erste Komponente ist, die dem Container hinzugefügt wurde. Stammdesigner unterscheiden sich von normalen Designern, da sie für die dem Endbenutzer angezeigte Benutzeroberfläche verantwortlich sind. Stammdesigner koordinieren sich in der Regel mit den restlichen Designern auf einer Entwurfsoberfläche, um diese Schnittstelle bereitzustellen.

Die Standardimplementierung dieser Methode delegiert an TypeDescriptor, die als Designertyp für Stammdesigner oder IDesigner für normale Designer übergeben IRootDesigner wird. Sie können diese Methode überschreiben, um einen bestimmten Typ von Designer anzufordern.