Como: Adicionar controles Windows Forms

Artigo
08/04/2011

A maioria dos formulários destinam-se adicionando controles para a superfície do formulário para definir uma interface de usuário (UI). A controle é um componente em um formulário usado para exibir informações ou aceitar a entrada do usuário. Para obter mais informações sobre controles, consulte Controles de Windows Forms.

Observação
As caixas de diálogo e comandos de menu demonstradas podem ser diferentes daqueles descritos na Ajuda, dependendo das configurações ativas ou configurações de edição. Para alterar as configurações, escolha Import and Export Settings sobre o Ferramentas menu. Para obter mais informações, consulte Trabalhando com configurações.

Para desenhar um controle em um formulário.

Abra o formulário. Para obter mais informações, consulte Como: Exibir Windows Forms no Designer.
No caixa de ferramentas, clique no controle que você deseja adicionar ao seu formulário.

No formulário, clique onde deseja que o canto superior esquerdo do controle para ser localizado e arraste para onde deseja que o canto inferior direito do controle para ser localizado.

O controle é adicionado ao formulário com o local especificado e o tamanho.

Observação
Cada controle tem um tamanho padrão definido. Você pode adicionar um controle para seu formulário no tamanho do padrão do controle, arrastando-a partir de caixa de ferramentas ao formulário.

Arraste um controle a um formulário

Abra o formulário. Para obter mais informações, consulte Como: Exibir Windows Forms no Designer.
No caixa de ferramentas, clique no controle desejado e arraste-o para seu formulário.

O controle é adicionado ao formulário no local especificado em seu tamanho padrão.

Observação

Você pode clicar duas vezes um controle no caixa de ferramentas para adicioná-lo para o canto superior esquerdo do formulário em seu tamanho padrão.

Você também pode adicionar controles dinamicamente a um formulário em tempo de execução. No exemplo de código a seguir, um TextBox controle será adicionado ao formulário quando um Button controle é clicado.

Observação

O procedimento a seguir requer a existência de um formulário com um botão controle, Button1, já colocou no proprietário.

Observação
Você pode clicar duas vezes um controle no caixa de ferramentas para adicioná-lo para o canto superior esquerdo do formulário em seu tamanho padrão.

Observação
O procedimento a seguir requer a existência de um formulário com um botão controle, Button1, já colocou no proprietário.

Para adicionar um controle a um formulário programaticamente

O método que manipula o botão Click evento dentro da classe do formulário, insira o código semelhante ao seguinte para adicionar uma referência para a variável de controle, defina o controle Locatione adicionar o controle.

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click
   Dim MyText As New TextBox()
   MyText.Location = New Point(25, 25)
   Me.Controls.Add(MyText)
End Sub

private void button1_Click(object sender, System.EventArgs e) 
{
   TextBox myText = new TextBox();
   myText.Location = new Point(25,25);
   this.Controls.Add (myText);
}

TextBox myText = new TextBox();
myText.set_Location(new Point(25, 25));
this.get_Controls().Add(myText);

private:
  System::Void button1_Click(System::Object ^  sender,
    System::EventArgs ^  e)
  {
    TextBox ^ myText = gcnew TextBox();
    myText->Location = Point(25,25);
    this->Controls->Add(myText);
  }

Observação
Você também pode adicionar código para inicializar as outras propriedades do controle.

Observação sobre segurança
Você poderá expor seu computador local para um risco de segurança através da rede consultando um mal-intencionado UserControl. Isso seria apenas uma preocupação em caso de uma pessoa mal-intencionada, criando um controle personalizado prejudicial, seguido por você por engano, adicioná-lo ao seu projeto.