Compartilhar via


ControlDesigner.EnableDesignMode(Control, String) Método

Definição

Habilita a funcionalidade de tempo de design para um controle filho.

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

Parâmetros

child
Control

O controle filho para o qual o modo de design será habilitado.

name
String

O nome do conforme child exposto ao usuário final.

Retornos

Boolean

true se o controle filho puder ser habilitado para o tempo de design; false se a infraestrutura de hospedagem não dá suporte a ele.

Exceções

child ou name é null.

Comentários

O controle filho especificado por child é um filho do controle desse designer de controle. O filho não participa diretamente da persistência, mas será exposto como uma propriedade do controle principal. Considere um controle como: SplitContainerele tem dois painéis Panel1 e Panel2. Esses painéis são expostos somente Panel1 leitura e Panel2 propriedades no SplitContainer controle. O SplitContainer designer do controle chama EnableDesignMode cada painel, o que permite que outros componentes sejam descartados sobre eles. Mas, para que o conteúdo de Panel1 e Panel2 para ser salvo, o SplitContainer próprio controle deve expor os painéis como propriedades públicas.

Os nomes de controle devem ser exclusivos dentro de um designer de controle, mas não precisam ser exclusivos em relação aos filhos de outros designers de controle.

Para dar suporte a esse recurso, a infraestrutura de hospedagem deve expor a INestedContainer classe como um serviço por meio do site.

Aplica-se a