Tutorial: Criar um aplicativo do Windows Forms com o .NET
Neste breve tutorial, você aprenderá a criar um novo aplicativo do Windows Forms com o Visual Studio. Depois que o aplicativo inicial for gerado, você aprenderá a adicionar controles e a lidar com eventos. Ao final deste tutorial, você terá um aplicativo simples que adiciona nomes a uma caixa de listagem.
Neste tutorial, você aprenderá a:
- 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.0 ou versões posteriores
- Selecione a carga de trabalho de desenvolvimento da área de trabalho do .NET
- Selecione o componente individual do .NET 6
- Visual Studio 2022 versão 17.4 ou versões posteriores
- Selecione a carga de trabalho de desenvolvimento da área de trabalho do .NET
- Selecione o componente individual do .NET 7
Dica
Use o Visual Studio 2022 versão 17.4 ou posterior e instale os componentes individuais do .NET 7 e do .NET 6. O suporte para .NET 7 foi adicionado no Visual Studio 2022 versão 17.4.
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.
Abra o Visual Studio.
Selecione Criar um novo projeto.
Na caixa Pesquisar modelos, digite winforms e aguarde até que os resultados da pesquisa apareçam.
Na lista suspensa da linguagem de código, escolha C# ou Visual Basic.
Na lista de modelos, selecione Aplicativo Windows Forms e clique em Avançar.
Importante
Não selecione o modelo do Aplicativo Windows Forms (.NET Framework).
A imagem a seguir mostra modelos de projeto C# e Visual Basic .NET. Se você aplicou o filtro de idioma de código, verá o modelo correspondente.
Na janela Configurar seu novo projeto, defina o Nome do projeto como Nomes e clique em Avançar.
Você também pode salvar seu projeto em uma pasta diferente ajustando o caminho Local.
Por fim, na janela Informações adicionais, selecione .NET 6.0 (suporte de longo prazo) para a configuração Estrutura e clique em Criar.
Abra o Visual Studio.
Selecione Criar um novo projeto.
Na caixa Pesquisar modelos, digite winforms e aguarde até que os resultados da pesquisa apareçam.
Na lista suspensa da linguagem de código, escolha C# ou Visual Basic.
Na lista de modelos, selecione Aplicativo Windows Forms e clique em Avançar.
Importante
Não selecione o modelo do Aplicativo Windows Forms (.NET Framework).
A imagem a seguir mostra modelos de projeto C# e Visual Basic .NET. Se você aplicou o filtro de idioma de código, verá o modelo correspondente.
Na janela Configurar seu novo projeto, defina o Nome do projeto como Nomes e clique em Avançar.
Você também pode salvar seu projeto em uma pasta diferente ajustando o caminho Local.
Por fim, na janela Informações adicionais, selecione .NET 7.0 (Suporte a Termo Padrão) para a configuração Estrutura e clique em Criar.
Depois que o aplicativo for gerado, o Visual Studio deverá abrir o painel de designer para o formulário padrão, Form1. Se o designer de formulários não estiver visível, clique duas vezes no formulário no painel 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ê interagirá ao criar um aplicativo:
Gerenciador de Soluções
Todos os seus arquivos de projeto, código, formulários, recursos aparecerão neste painel.
Propriedades
Este painel mostra as configurações de propriedade que você pode definir com base no item selecionado. Por exemplo, se você selecionar um item do Gerenciador de Soluções, verá as configurações de propriedade relacionadas ao arquivo. Se você selecionar um objeto no Designer, verá as configurações do controle ou do formulário.
Design de Formulário
Este é o designer do formulário. É interativo e você pode arrastar e soltar objetos da Caixa de Ferramentas. Ao selecionar e mover itens no designer, você pode compor visualmente a interface do usuário (interface do usuário) do seu aplicativo.
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 por meio do item de menu Exibir>Caixa de Ferramentas.
Adicionar controles ao formulário
Com o designer de formulários Form1 aberto, use o painel Caixa de Ferramentas para adicionar os seguintes controles ao formulário:
- Etiqueta
- Botão
- Caixa de listagem
- Caixa de texto
Você pode posicionar e dimensionar os controles de acordo com as configurações a seguir. Mova-os visualmente para corresponder à captura de tela a seguir ou clique em cada controle e defina as configurações no painel Propriedades . Você também pode clicar na área de título do formulário para selecionar o formulário:
Objeto | Configuração | Valor |
---|---|---|
Formulário | Texto | Names |
Tamanho | 268, 180 |
|
Rótulo | Localidade | 12, 9 |
Texto | Names |
|
Caixa de listagem | Nome | lstNames |
Localidade | 12, 27 |
|
Tamanho | 120, 94 |
|
Caixa de texto | Nome | txtName |
Localidade | 138, 26 |
|
Tamanho | 100, 23 |
|
Botão | Nome | btnAdd |
Localidade | 138, 55 |
|
Tamanho | 100, 23 |
|
Texto | Add Name |
Você deve ter um formulário no designer semelhante ao seguinte:
Tratar eventos
Agora que o formulário tem todos os seus controles definidos, você precisa manipular os eventos dos controles para responder à entrada do usuário. Com o designer de formulários ainda aberto, execute as seguintes etapas:
Selecione o controle de botão no formulário.
No painel Propriedades, clique no ícone de eventos para listar os eventos do botão.
Localize o evento Click e clique duas vezes nele para gerar um manipulador de eventos.
Essa 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 que colocaremos nesse manipulador adicionará o nome especificado pelo
txtName
controle textbox aolstNames
controle listbox. No entanto, queremos que haja duas condições para adicionar o nome: o nome fornecido não deve estar em branco e o nome ainda não deve existir.O código a seguir demonstra a adição de um nome ao
lstNames
controle: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 codificado, você pode executar o aplicativo pressionando a tecla F5 ou selecionando Depurar>Iniciar Depuração no menu. O formulário é exibido e você pode inserir um nome na caixa de texto e adicioná-lo clicando no botão.
Próximas etapas
.NET Desktop feedback