Como criar seu primeiro aplicativo Windows Forms (Winforms) no Visual Studio

O Windows Forms é uma estrutura disponível no Visual Studio que permite criar aplicativos de área de trabalho com a ajuda de uma interface gráfica do usuário. Isso permite que você clique e arraste widgets, como botões ou rótulos, diretamente para uma tela e manipule as propriedades de cada widget, como tamanho da fonte, cor ou borda.

Neste artigo, um simples conversor de Celsius para Fahrenheit será usado como exemplo para passar pelo básico de como configurar um aplicativo Windows Form. O Visual Studio 2019 Community Edition é a edição usada para este tutorial.

Como criar o projeto Windows Forms no Visual Studio

Primeiro, crie o projeto no Visual Studio.

1. Abra o Visual Studio e selecione Criar um novo projeto.
2. O Visual Studio fornecerá uma lista de modelos de projeto que você pode escolher.
3. Para criar um aplicativo Windows Forms, procure Aplicativo Windows Form e selecione-o na lista de modelos. Uma vez selecionado, clique em Próximo.

   Se o Aplicativo Windows Form opção não está disponível na lista,

   instagram viewer

   modificar sua versão instalada do Visual Studio. No Instalador do Visual Studio, adicione a carga de trabalho de desenvolvimento de desktop .NET para Desktop e Mobile e reinicie o Visual Studio.

4. Adicione um nome e local para o projeto e clique em Próximo. A localização é o diretório onde os arquivos de código serão armazenados.
5. Na próxima tela, mantenha a seleção padrão de .NET Core 3.1.
6. Clique Crio.
7. Depois que o Visual Studio terminar de criar o projeto, o projeto será aberto.

Como adicionar elementos à tela do projeto

A tela é a área branca localizada no canto superior esquerdo da tela. Clique e arraste os pontos na parte inferior, direita ou inferior direita da tela para redimensioná-la, se necessário.

Para criar a interface do usuário do aplicativo, adicione widgets como botões ou caixas de texto na tela.

1. Abra o Exibir guia na parte superior da janela e selecione Caixa de ferramentas.
2. Isso adicionará uma caixa de ferramentas ao lado esquerdo do aplicativo. Selecione os ícone de alfinete no canto superior direito da caixa de ferramentas para fixá-lo permanentemente.
3. É aqui que você pode arrastar qualquer widget da caixa de ferramentas para a tela. Realce um botão da caixa de ferramentas e arraste-o para a tela.
4. Arraste mais duas caixas de texto para a tela, juntamente com três rótulos (dois rótulos para cada caixa de texto e um rótulo para o título na parte superior do aplicativo).
5. Cada widget na tela tem propriedades associadas a eles. Realce um widget para exibir o Propriedades janela no canto inferior direito do Visual Studio, que lista todas as propriedades que o widget possui. Essas propriedades podem incluir texto, nome, tamanho da fonte, borda ou alinhamento do widget realçado.
6. No momento, o texto nesses widgets ainda diz rótulo1, rótulo2, ou botão1. Selecione os rótulo1 widget e edite o Texto propriedade na janela de propriedades para dizer "Celsius to Fahrenheit". Altere o tamanho da fonte para 22pt.
7. Da mesma forma, edite as propriedades dos outros widgets na tela para serem as seguintes:

   Ferramenta	Propriedade	Novo valor
   rótulo2	Texto	Celsius
   rótulo3	Texto	Fahrenheit
   botão	Texto	Calcular
   caixa de texto Fahrenheit	Somente leitura	Verdadeiro

Como lidar com eventos e escrever código no code-behind

Widgets na tela podem ser vinculados a eventos. Os eventos podem incluir coisas como clicar em um botão, alterar o texto dentro de uma caixa de texto ou selecionar um botão de opção específico. Quando esses eventos acontecem, pode fazer com que uma seção de código no Code-Behind seja acionada.

C# é a linguagem usada ao criar Windows Forms. Se você ainda não usou C#, há muitas razões práticas para aprender programação C#.

Para este aplicativo específico, adicione um evento ao Calcular botão, para acionar uma seção de código a ser executada quando este botão for pressionado.

1. Clique duas vezes no Calcular botão para abrir Form1.cs automaticamente com um novo método Event:

   private void calcularButton_Click (remetente do objeto, EventArgs e)

2. É aqui que você adicionará o código que realizará o cálculo de Celsius para Fahrenheit e exibirá o resultado na caixa de texto Fahrenheit. Para fazer isso, você precisa ser capaz de ler o valor da caixa de texto Celsius e modificar a caixa de texto Fahrenheit para exibir o resultado.
3. Volte para a tela e reedite as propriedades como mostrado antes. Desta vez, edite o Nome propriedade para as caixas de texto Celsius e Fahrenheit. Esses nomes podem ser usados ​​para fazer referência às caixas de texto no código.

   Ferramenta	Propriedade	Novo valor
   Caixa de texto Celsius	Nome	celsiusTextBox
   Caixa de texto Fahrenheit	Nome	FahrenheitTextBox

4. Volte para a função calculateButton_Click em Form1.cs.
5. Agora, a caixa de texto Celsius pode ser referenciada no código usando o nome "celsiusTextBox". O valor Celsius que o usuário digitou é armazenado em sua propriedade Text. No entanto, como é uma string, analise isso em um double para incluí-lo nos cálculos futuros de Fahrenheit.

   private void calcularButton_Click (remetente do objeto, EventArgs e)
   {
    // Obtém o valor que o usuário digitou na caixa de texto Celsius
    double celsiusValue = Double. Analisar (celsiusTextBox. Texto);
   }

6. A variável celsiusValue agora armazena o valor que o usuário inseriu na caixa de texto Celsius. A fórmula para converter Celsius para Fahrenheit é (celsiusValue * 9/5) + 32. Portanto, o resultado agora pode ser calculado e armazenado na caixa de texto Fahrenheit.

   private void calcularButton_Click (remetente do objeto, EventArgs e)
   {
    // Obtém o valor que o usuário digitou na caixa de texto Celsius
    double celsiusValue = Double. Analisar (celsiusTextBox. Texto);
    //Aplica o cálculo
    resultado duplo = (celsiusValue * 9 / 5) + 32;
    // Armazena o resultado na caixa de texto Fahrenheit
    fahrenheitTextBox. Texto = resultado. Para sequenciar();
   }

Como executar e depurar o programa Windows Forms

Executando o programa Windows Forms no Visual Studio

Agora que a interface do usuário e a lógica do código estão configuradas, execute o programa para vê-lo funcionando.

1. Para executar o programa, selecione a seta verde na parte superior da barra de ferramentas no Visual Studio.
2. Depois que o projeto for carregado, adicione um valor na caixa de texto Celsius e pressione o botão Calcular botão. Isso adicionará o resultado na caixa de texto Fahrenheit.
3. Se o programa estiver embaçado em tempo de execução, é provável que seu aplicativo não esteja ciente de DPI. Isso pode causar problemas de dimensionamento e resolução, portanto, isso precisará ser ativado. Você também pode ler mais sobre configurando o dimensionamento de exibição no Windows 10 para monitores de alto DPI.
4. Clique com o botão direito do mouse no Projeto Conversor de Temperatura no Explorador de soluções. Selecionar Adicionar, em seguida, selecione Novo item.
5. Procure o arquivo de manifesto do aplicativo e clique em Adicionar.
6. Copie o código a seguir para o novo arquivo app.manifest, como filho da tag assembly (se o código já foi gerado, basta descomentar).

   
   
   verdadeiro
   verdadeiro
   
   

7. Para que essa alteração tenha efeito, execute novamente o programa. Selecione o botão vermelho de parada na parte superior da barra de ferramentas e, em seguida, selecione o botão verde de reprodução novamente.

Depurando o programa Windows Forms

Convém depurar o programa se a lógica do aplicativo Windows Forms não estiver funcionando conforme o esperado.

1. Navegue de volta para a função calculateButton_Click em Form1.cs e clique em qualquer lugar na barra cinza na extremidade esquerda da tela. Isso adicionará um ponto de interrupção, indicado por um círculo vermelho.
2. Pressione o botão "Calcular" novamente para acionar este método para executar. O programa fará uma pausa quando atingir o ponto de interrupção para mostrar todos os valores armazenados nas variáveis ​​naquele ponto.
3. Para continuar o programa, clique no botão verde Continuar seta na parte superior da barra de ferramentas.

Executando o programa usando um arquivo executável

Se você não quiser executar seu programa por meio do Visual Studio, use o arquivo executável autônomo para o programa. Isso é gerado automaticamente.

1. Navegue até o arquivo executável, que pode ser encontrado aqui:

   /bin/Debug/netcoreapp3.1/TemperatureConverter.exe

2. Clique no arquivo executável para executar diretamente o programa.

Adicionando mais ao seu Windows Form

Espero que agora você tenha um entendimento básico da estrutura básica de um aplicativo Windows Form. Você pode continuar explorando recursos adicionais do Windows Forms experimentando novos widgets e se aprofundando nos outros vários eventos que podem ser tratados.

Quando estiver mais familiarizado com o Windows Forms, você poderá começar a criar aplicativos mais complexos. Você também pode explorar muitas outras maneiras de criar aplicativos na área de trabalho do Windows.

Sobre o autor