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

  • Artigo

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 como um controle é adicionado 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 de código.

Importante

A documentação do Guia da Área de Trabalho para .NET 7 e .NET 6 está em construção.

Adicionar com o Designer

Visual Studio usa o Forms Designer 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:

Adicione o controle clicando duas vezes em

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

Double-click a control in the toolbox on visual studio for .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.

Drag-select and draw a control from the toolbox on visual studio for .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