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 de child como exposto ao usuário final.

Retornos

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

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á se for 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 por meio de 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 neles. 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