Compartilhar via


Adicionar um controle a um formulário (Windows Forms .NET)

A maioria dos formulários é projetada adicionando controles à superfície do formulário para definir uma interface do usuário (IU). Um controle é um componente em um formulário usado para exibir informações ou aceitar a entrada do usuário.

A principal maneira de adicionar um controle a um formulário é por meio do Visual Studio Designer, mas você também pode gerenciar os controles em um formulário em tempo de execução por meio do código.

Adicionar com o Designer

O Visual Studio usa o Designer de Formulários para criar formulários. Há um painel Controles que lista todos os controles disponíveis para seu aplicativo. Você pode adicionar controles do painel de duas maneiras:

Adicionar o controle clicando duas vezes

Quando um controle é clicado duas vezes, ele é adicionado automaticamente ao formulário aberto atual com as configurações padrão.

Clique duas vezes em um controle na caixa de ferramentas do Visual Studio para .NET Windows Forms

Adicionar o controle desenhando

Selecione o controle clicando nele. No formulário, arraste e selecione uma região. O controle será colocado para se ajustar ao tamanho da região selecionada.

Arrastar, selecionar e desenhar um controle da caixa de ferramentas no Visual Studio para .NET Windows Forms

Adicionar com código

Os controles podem ser criados e adicionados a um formulário em tempo de execução com a coleção do Controls formulário. Essa coleção também pode ser usada para remover controles de um formulário.

O código a seguir adiciona e posiciona dois controles, um Label e um TextBox:

Label label1 = new Label()
{
    Text = "&First Name",
    Location = new Point(10, 10),
    TabIndex = 10
};

TextBox field1 = new TextBox()
{
    Location = new Point(label1.Location.X, label1.Bounds.Bottom + Padding.Top),
    TabIndex = 11
};

Controls.Add(label1);
Controls.Add(field1);
Dim label1 As New Label With {.Text = "&First Name",
                              .Location = New Point(10, 10),
                              .TabIndex = 10}

Dim field1 As New TextBox With {.Location = New Point(label1.Location.X,
                                                      label1.Bounds.Bottom + Padding.Top),
                                .TabIndex = 11}

Controls.Add(label1)
Controls.Add(field1)

Confira também