Partilhar via


Como: Adicionar controles ao Windows Forms

A maioria dos formulários é projetada adicionando controles à superfície do formulário para definir uma interface do usuário (UI). Um controlo é um componente num formulário usado para exibir informações ou aceitar dados do utilizador. Para obter mais informações sobre controles, consulte Controles do Windows Forms.

Para desenhar um controle em um formulário

  1. Abra o formulário. Para obter mais informações, consulte Como exibir Windows Forms no Designer.

  2. Na Caixa de Ferramentas, clique no controlo que pretende adicionar ao formulário.

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

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

    Observação

    Cada controle tem um tamanho padrão definido. Você pode adicionar um controle ao seu formulário no tamanho padrão arrastando-o da Caixa de Ferramentas para o formulário.

Para arrastar um controle para um formulário

  1. Abra o formulário. Para obter mais informações, consulte Como exibir Windows Forms no Designer.

  2. Na Caixa de Ferramentas , clique no controlo desejado e arraste-o para o seu formulário.

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

    Observação

    Você pode clicar duas vezes num controle na Caixa de Ferramentas para adicioná-lo ao canto superior esquerdo do formulário no 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 controle TextBox será adicionado ao formulário quando um controle Button for clicado.

    Observação

    O procedimento a seguir requer a existência de um formulário com um controlo de botão , Button1, já presente nele.

Para adicionar um controle a um formulário programaticamente

  1. No método que manipula o evento Click do botão dentro da classe do formulário, insira um código semelhante ao seguinte para adicionar uma referência à variável de controle, defina a Locationdo controle e adicione 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);
    }
    
    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 outras propriedades do controle.

    Importante

    Você pode expor seu computador local a um risco de segurança através da rede fazendo referência a um UserControlmal-intencionado. Isso só seria uma preocupação no caso de uma pessoa mal-intencionada criar um controle personalizado prejudicial, seguido por você adicioná-lo erroneamente ao seu projeto.

Ver também