DesignSurface.CreateDesigner(IComponent, Boolean) Método

Definição

Namespace:

System.ComponentModel.Design

Assembly:

System.Windows.Forms.Design.dll

Cria um designer quando um componente é adicionado ao contêiner.

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

Parâmetros

component

IComponent

O componente para o qual o designer deve ser criado.

rootDesigner

Boolean

true para criar um designer raiz; false para criar um designer normal.

Retornos

IDesigner

Uma instância do designer solicitado ou null, se nenhum designer correspondente pôde ser encontrado.

Exceções

ArgumentNullException

component é null.

ObjectDisposedException

O IDesignerHost anexado a DesignSurface foi descartado.

Comentários

O CreateDesigner método é chamado pela superfície de design quando IContainer um componente é adicionado ao contêiner. Esse método cria um designer, mas não o inicializa. Quando ele retorna, o designer é inicializado pelo contêiner.

CreateDesigner pode criar dois tipos diferentes de designers: designers raiz e designers normais. Um designer raiz é um designer para o componente raiz na superfície de design, que, por definição, é o primeiro componente adicionado ao contêiner. Os designers raiz diferem dos designers normais porque são responsáveis pela interface do usuário apresentada ao usuário final. Os designers raiz normalmente coordenam com o restante dos designers em uma superfície de design para fornecer essa interface.

A implementação padrão desse método delega para TypeDescriptor, passando IRootDesigner como o tipo de designer para designers raiz ou IDesigner para designers normais. Você pode substituir esse método para solicitar um tipo específico de designer.