ControlDesigner.EnableDesignMode(Control, String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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.