DesignSurface.CreateDesigner(IComponent, Boolean) Metodo

Definizione

Spazio dei nomi:

System.ComponentModel.Design

Assembly:

System.Windows.Forms.Design.dll

Crea una finestra di progettazione quando un componente viene aggiunto al contenitore.

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

Parametri

component

IComponent

Componente per il quale creare la finestra di progettazione.

rootDesigner

Boolean

true per creare una finestra di progettazione radice; false per creare una finestra di progettazione normale.

Restituisce

IDesigner

Istanza della finestra di progettazione richiesta oppure null se non è possibile individuare la finestra di progettazione corrispondente.

Eccezioni

ArgumentNullException

component è null.

ObjectDisposedException

L'interfaccia IDesignerHost collegata all'oggetto DesignSurface è stata eliminata.

Commenti

Il CreateDesigner metodo viene chiamato dall'area di IContainer progettazione quando un componente viene aggiunto al contenitore. Questo metodo crea una finestra di progettazione, ma non la inizializza. Al termine, la finestra di progettazione viene inizializzata dal contenitore.

CreateDesigner può creare due tipi diversi di finestre di progettazione: finestre di progettazione radice e finestre di progettazione normali. Una finestra di progettazione radice è una finestra di progettazione per il componente radice nell'area di progettazione, che per definizione è il primo componente aggiunto al contenitore. Le finestre di progettazione radice differiscono dalle finestre di progettazione normali perché sono responsabili dell'interfaccia utente presentata all'utente finale. Le finestre di progettazione radice si coordinano in genere con il resto delle finestre di progettazione in un'area di progettazione per fornire questa interfaccia.

L'implementazione predefinita di questo metodo delega a TypeDescriptor, passando IRootDesigner come tipo di finestra di progettazione per le finestre di progettazione radice o IDesigner per le finestre di progettazione normali. È possibile eseguire l'override di questo metodo per richiedere un tipo specifico di finestra di progettazione.