Tutorial: Criar um aplicativo do Windows Forms com .NET

Neste tutorial, você aprenderá a usar o Visual Studio para criar um novo aplicativo Windows Forms. Com o Visual Studio, você adiciona controles a um formulário e manipula eventos. No final deste tutorial, você tem um aplicativo simples que adiciona nomes a uma caixa de listagem.

Neste tutorial, você:

• Criar um novo aplicativo do Windows Forms
• Adicionar controles a um formulário
• Manipular eventos de controle para fornecer funcionalidade do aplicativo
• Executar o aplicativo

Pré-requisitos

• Visual Studio 2022 versão 17.12 ou versões posteriores
  • Selecione a carga de trabalho de desenvolvimento da área de trabalho .NET
  • Selecione o componente individual .NET 9

Criar um aplicativo do Windows Forms

A primeira etapa para criar um novo aplicativo é abrir o Visual Studio e gerar o aplicativo a partir de um modelo.

1. Abra o Visual Studio.

2. Selecione Criar um novo projeto.

   

3. Na caixa Pesquisar modelos, digite winformse aguarde até que os resultados da pesquisa apareçam.

4. Na lista suspensa de linguagem de código , escolha C# ou Visual Basic.

5. Na lista de modelos, selecione Windows Forms App e, em seguida, selecione Avançar.

   Importante

   Não selecione o Windows Forms App (.NET Framework) modelo.

   A imagem a seguir mostra modelos de projeto C# e Visual Basic .NET. Se aplicaste o filtro de linguagem de código , o modelo correspondente é listado.

   

6. Na janela Configurar o seu novo projeto, defina o nome do projeto como Nomes e selecione Seguinte.

   Você também pode salvar seu projeto em uma pasta diferente, ajustando o Local caminho.

   

7. Finalmente, na janela informações adicionais, selecione .NET 9.0 (Suporte de Prazo Padrão) para a configuração do Framework e, em seguida, selecione Criar.

   

Depois que o aplicativo é gerado, o Visual Studio deve abrir a janela do designer para o formulário padrão, Form1. Se o designer de formulário não estiver visível, clique duas vezes no formulário na janela Gerenciador de Soluções para abrir a janela do designer.

Partes importantes do Visual Studio

O suporte para Windows Forms no Visual Studio tem quatro componentes importantes com os quais você interage ao criar um aplicativo:

1. Explorador de Soluções

   Todos os seus arquivos de projeto, código, formulários, recursos, aparecem nesta janela.

2. Propriedades

   Esta janela mostra as configurações de propriedade que você pode configurar com base no contexto do item selecionado. Por exemplo, se você selecionar um item Gerenciador de Soluções, as configurações relacionadas ao arquivo serão exibidas. Se o objeto no Designer estiver selecionado, as propriedades do controle ou formulário são apresentadas.

3. Designer de Formulários

   Este é o designer para o formulário. É interativo e você pode arrastar e soltar objetos do Toolbox. Ao selecionar e mover itens no designer, você pode compor visualmente a interface do usuário (UI) para seu aplicativo.

4. Caixa de ferramentas

   A caixa de ferramentas contém todos os controles que você pode adicionar a um formulário. Para adicionar um controle ao formulário atual, clique duas vezes em um controle ou arraste e solte o controle.

Dica

Se a caixa de ferramentas não estiver visível, você poderá exibi-la através do item de menu Exibir>Caixa de Ferramentas.

Adicionar controles ao formulário

Com o Form1 designer de formulário aberto, use a janela Toolbox para adicionar os seguintes controles ao formulário arrastando-os da caixa de ferramentas e soltando-os no formulário:

• Botão
• Etiqueta
• Caixa de listagem
• Caixa de texto

Posicione e dimensione os controles de acordo com a seguinte imagem:

Você pode mover e redimensionar os controles com o mouse para corresponder à imagem anterior ou usar a tabela a seguir para configurar cada controle. Para configurar um controle, selecione-o no designer e defina a configuração apropriada na janela Propriedades . Ao configurar o formulário, selecione a barra de título do formulário.

Objeto	Configuração	Valor
Rótulo	Localização	12, 9
	Texto	Names
Caixa de listagem	Nome	lstNames
	Localização	12, 27
	Tamanho	120, 94
Caixa de texto	Nome	txtName
	Localização	138, 26
	Tamanho	100, 23
botão	Nome	btnAdd
	Localização	138, 55
	Tamanho	100, 23
	Texto	Add Name
Formulário	Texto	Names
	Tamanho	268, 180

Gerir eventos

Agora que o formulário tem todos os seus controles definidos, a próxima etapa é adicionar manipuladores de eventos para responder à entrada do usuário. Vá para o designer de formulário e execute as seguintes etapas:

1. Selecione o botão de controlo Adicionar Nome no formulário.

2. Na janela Propriedades, selecione o ícone de eventos para listar os eventos do botão.

3. Encontre o evento Click e clique duas vezes nele para gerar um manipulador de eventos.

   Esta ação adiciona o seguinte código ao formulário:

   private void btnAdd_Click(object sender, EventArgs e)
   {
   
   }
   

   Private Sub btnAdd_Click(sender As Object, e As EventArgs) Handles btnAdd.Click
   
   End Sub
   

   O código para esse manipulador adicionará o nome especificado pela caixa de texto txtName à caixa de listagem lstNames. No entanto, queremos que haja duas condições para adicionar o nome: o nome fornecido não deve estar em branco e o nome não deve já existir.

4. O código a seguir demonstra a adição de um nome para o controle lstNames:

   private void btnAdd_Click(object sender, EventArgs e)
   {
       if (!string.IsNullOrWhiteSpace(txtName.Text) && !lstNames.Items.Contains(txtName.Text))
           lstNames.Items.Add(txtName.Text);
   }
   

   Private Sub btnAdd_Click(sender As Object, e As EventArgs) Handles btnAdd.Click
       If Not String.IsNullOrWhiteSpace(txtName.Text) And Not lstNames.Items.Contains(txtName.Text) Then
           lstNames.Items.Add(txtName.Text)
       End If
   End Sub
   

Executar o aplicativo

Agora que o evento foi manipulado, execute a aplicação pressionando a tecla F5 ou selecionando Depurar>Iniciar a Depuração no menu. Quando o aplicativo é iniciado, o formulário é exibido e você pode inserir um nome na caixa de texto e selecionar o botão.

Conteúdo relacionado

• Saiba mais sobre o Windows Forms
• Visão geral do uso de controles
• Visão geral de eventos