PROGRAMAÇÃO PRÁTICA

C# Windows
Forms Application
Uma introdução passo a passo

Gilseone Moraes PROGRAMAÇÃO PRÁTICA

 PROGRAMAÇÃO PRÁTICA

C# Windows Forms Application

Uma introdução passo a passo

Gilseone Moraes
Santa Maria/RS
 PROGRAMAÇÃO PRÁTICA

Nós só podemos ver um

pouco do futuro, mas o
suficiente para perceber
que há muito a fazer.

Alan Turing

Gilseone Moraes
Santa Maria/RS
SOBRE ESTE EBOOK

Este eBook visa ensinar de maneira simples, mostrando o que

é necessário para dar os primeiros passos para a construção de
aplicações C# Windows Forms Application. Se é um assunto que
você gosta e tem interesse em aprender, então este material vai
lhe ajudar a começar seus estudos.

Atualizações serão feitas constantemente e disponibilizadas no

site ProgramacaoPratica.com.br. Espero que você aproveite
este material. Todos os comentários, críticas e sugestões serão
muito bem-vindos.

Baixe sempre a versão mais recente e atualizada em:

ProgramacaoPratica.com.br/ebooks

Este material é parte integrante do curso de C# e Windows Forms

Application publicado na Udemy (conheça o curso clicando aqui).
A distribuição, cópia, revenda e utilização para ministrar
treinamentos são absolutamente proibidas. Para uso comercial
deste material, por favor, consulte o autor previamente pelo
e-mail [email protected].

04
Boa leitura!

PROGRAMAÇÃO PRÁTICA
REDES SOCIAIS

Facebook Curta a Página

YouTube Inscreva-se no Canal

GitHub Repositório de Cursos Gratuitos

Telegram Entre no Grupo

Instagram Siga no Instagram

Twitter Siga no Twitter

Udemy Conheça os Cursos

Site Acesse o site

PROGRAMAÇÃO PRÁTICA 05
SUMÁRIO

1. INTRODUÇÃO....................................................................07
2. CRIANDO UM PROJETO NO VISUAL STUDIO..................09
2.1. PRIMEIRA ETAPA..........................................................10
2.2. SEGUNDA ETAPA..........................................................11
2.3. TERCEIRA ETAPA..........................................................17
2.4. QUARTA ETAPA............................................................21
3. PRINCIPAIS CONTROLES...................................................22
3.1. LABEL............................................................................24
3.2. TEXTBOX.......................................................................26
3.3. LISTBOX........................................................................28
3.4. RADIOBUTTON.............................................................31
3.5. GROUPBOX..................................................................34
3.6. CHECKBOX...................................................................36
3.7. BUTTON........................................................................38
4. PADRÕES DE NOMENCLATURA........................................40

PROGRAMAÇÃO PRÁTICA 06
1. INTRODUÇÃO

PROGRAMAÇÃO PRÁTICA
Windows Forms é uma biblioteca de classes da Interface
Gráfica do Usuário (GUI) incluída no .Net Framework. Seu
principal objetivo é fornecer uma interface mais fácil para o
desenvolvimento de apliações para desktop, que rodam Sistema
Operacional Windows. Também denominado como WinForms,
estes aplicativos podem conter diferentes tipos de controles,
como botões, rótulos, caixas de texto etc.

Este ebook se concentrará em como podemos criar aplicativos

baseados no Windows. Também aprenderemos algumas noções
básicas sobre como trabalhar com alguns dos principais controles
disponíveis para criação dos formulários que compõem as
aplicações.

Para os exemplos mostrados neste ebook será usado o Visual

Studio 2017, em inglês. Logo, se você tem instalada outra versão,
poderá identificar algumas diferenças na criação e manipulação
do projeto.

PROGRAMAÇÃO PRÁTICA 08
2. Criando um
projeto no
Visual Studio

PROGRAMAÇÃO PRÁTICA
Para criar um um novo projeto no Visual Studio precisamos
seguir quatro etapas bem simples:

2.1. Primeira Etapa

A primeira etapa envolve a criação de um novo projeto no Visual

Studio. Depois de iniciar o Visual Studio, você precisa escolher a opção
de menu “File” -> “New” -> “Project”, conforme a imagem abaixo.

PROGRAMAÇÃO PRÁTICA 10
2.2. Segunda Etapa

A próxima etapa é definir o tipo de projeto como um aplicativo

Windows Forms. Aqui também precisamos informar o nome e a
localização do nosso projeto, conforme a imagem abaixo.

PROGRAMAÇÃO PRÁTICA 11
A. Na caixa de diálogo do projeto, podemos ver várias opções
para criar diferentes tipos de projetos no Visual Studio. Clique na
opção “Windows Desktop” no lado esquerdo.

B. Quando clicamos na opção do “Windows Desktop” no item

anterior, são exibidos os templates instalados deste tipo de
projeto. Clique no item “Windows Forms App (.Net Framework)”.

C. Em seguida, atribuímos um nome para o projeto que, em nosso

caso, é “PrimeiroProjeto”. Também precisamos fornecer um local
onde o projeto será criado, um nome para a solução e a versão do “.Net
Framework”. Perceba que os campos “Name”, “Location”, “Solution
Name” e “Framework” já estão preenchidos, desta forma você deve
alterá-los conforme houver necessidade. Para este exemplo, não
altere o valor de “Location”, forneça um nome “PrimeiraSolucao”
para a solução e a versão 4.5 para o .Net Framework.

D. Marque a caixa de seleção “Create Directory for Solution”.

Isso permite que seja criada uma pasta principal para a solução
e dentro dela uma pasta para cada projeto adicionado, desta
maneira você garantirá a organização dos seus projetos.

E. Por fim, clique no botão “OK” para permitir que o Visual Studio
crie nosso projeto e a sua solução.

PROGRAMAÇÃO PRÁTICA 12
Se as etapas acima forem seguidas, você obterá a saída abaixo
no Visual Studio.

PROGRAMAÇÃO PRÁTICA 13
Na janela exibida para você poderá existir uma diferença do lado
esquerdo, não exibindo a guia com os controles existentes. Para
mostrá-la basta clicar em “Toolbox”. Caso você altere sem querer
o layout da janela e precise redefiní-lo, reconfigurando-o como
padrão, vá para “Window" -> "Reset Window Layout” no Visual
Studio. A janela do Visual Studio posuirá três partes principais
onde você manipulará os seus projetos:

1º. Janela do Editor ou Janela Principal: Aqui, você trabalhará com o

design formulários e edição de código. Você pode observar o layout
do formulário que agora está em branco. Para visualizar o código
pressione a tecla “F7” do teclado, conforme a imagem abaixo.

PROGRAMAÇÃO PRÁTICA 14
2º. Janela do Gerenciador de Soluções ou “Solution Explorer”: É usada
para navegar entre todos os itens da solução (imagem abaixo). Por
exemplo, se você selecionar um arquivo nesta janela, informações
específicas dele serão exibidas na janela de propriedades.

• Perceba que a solução é como um contêiner que contém os

projetos e arquivos que podem ser solicitados pelo programa.
No “Solution Explorer”, você poderá ver a solução criada.

• Neste exemplo, a solução conterá os 2 arquivos de projeto,

conforme pode ser visualizado na imagem abaixo. O primeiro arquivo
corrersponde ao formulário chamado “Form1.cs”. Este arquivo
conterá todo o código para o aplicativo “Windows Form”. O segundo
arquivo corresponde
ao programa principal
chamado “Program.cs”
é o arquivo de código
padrão criado quando
um novo aplicativo é
criado no Visual Studio.
Este código conterá o
código de inicialização
do aplicativo como um
todo.

PROGRAMAÇÃO PRÁTICA 15
3º. Janela de Propriedades ou “Properties”: Essa janela é usada
para alterar as diferentes propriedades do item selecionado no
Gerenciador de Soluções.

• Você pode alterar as propriedades dos componentes ou

controles que você adicionará aos formulários durante a edição
na janela principal.

• Para acessar as propriedades de

um controle basta você clicar sobre
o componente. Existem situações
onde a Janela de Propriedades não
está sendo exibida. Neste caso clique
com o botão direito do mouse no
controle e escolha a opção de menu
“Properties”.

• Na imagem ao lado são exibidas as

propriedades do formulário “Form1”
que está selecionado.

PROGRAMAÇÃO PRÁTICA 16
2.3. TERCEIRA Etapa

A próxima etapa consiste em adicionar controles ao formulário.

No lado esquerdo do Visual Studio, você também verá uma caixa
de ferramentas chamada “Toolbox”. Esta caixa de ferramentas
contém todos os controles que podem ser adicionados a um
Formulário Windows. Controles como uma caixa de texto ou um
rótulo são apenas alguns dos controles que podem ser usados
em uma aplicação Windows. Perceba que os controles da
“Toolbox” somente serão exibidos se você estiver com o design
do formulário aberto na janela principal (Imagem 7).

PROGRAMAÇÃO PRÁTICA 17
Agora arraste e solte os controles necessários no formulário
criado. Por exemplo, você pode adicionar Botton, GroupBox,
Label, ListBox, etc., como mostrado abaixo. Cada componente
tem um propósito e você deverá planejar sua aplicação levando
em conta a disposição dos componentes em cada formulário.

PROGRAMAÇÃO PRÁTICA 18
Ao clicar em cada controle dentro da janela principal, você pode
ver e alterar as suas propriedades presentes no canto inferior à
direita do Visual Studio.

Imagem 9

PROGRAMAÇÃO PRÁTICA 19
Na imagem da página anterior, você pode ver que o componente
"Button" está selecionado e ele possue propriedades como
"Location", "Size", "Text", etc., que são exibidas no canto inferior
direito na Janela de Propriedades. Você pode alterar os valores
das propriedades de acordo com a necessidade da aplicação
que você precisa desenvolver.

O código dos controles será adicionado automaticamente em

segundo plano, conforme o formulário vai sendo modificado.
Você pode verificar isso no arquivo "Form1.Designer.cs" presente
na janela Solution Explorer (imagem abaixo). Para cada formulário
que você adicionar ao seu projeto, um arquivo “.Desiner.cs” será
automaticamente criado.

PROGRAMAÇÃO PRÁTICA 20
2.4. QUARTA Etapa

Para executar o programa, você pode usar uma tecla "F5" ou o

botão “Start’ presente na barra de ferramentas do Visual Studio
(imagem abaixo). Para interromper o programa, você pode
usar o botão “Pause” presente na barra de ferramentas. Você
também pode executar o programa acessando o menu “Debug"
-> "Start Debugging” na barra de menus.

Ou

PROGRAMAÇÃO PRÁTICA 21
3. Principais
Controles

PROGRAMAÇÃO PRÁTICA
 O .Net Framework oferece vários
controles e componentes que
executam determinadas funções
em aplicações Windows Forms.

Nesta seção são abordados os

principais controles disponíveis
na "Toolbox" de acordo com a
sua finalidade (imagem ao lado).

Para cada controle são descritas as

suas funções e algumas principais
propriedades que podem ser
modificadas.

PROGRAMAÇÃO PRÁTICA 23
3.1. Label

O controle Label também é chamado de Rótulo. Este componente

usado para exibir um texto ou uma mensagem para o usuário no
formulário. Este controle é normalmente usado junto com outros
controles, indicando por exemplo o que deve ser preenchido nas
caixas de texto. Vamos ver como podemos implementar isso com
um exemplo mostrado abaixo. Adicionaremos dois rótulos ao
formulário, um para o nome e o outro para o endereço.

3.1.1. Primeira Etapa

A primeira etapa é arrastar da Toolbox os controles de rótulo para

dentro do formulário, como mostrado abaixo.

PROGRAMAÇÃO PRÁTICA 24
3.1.2. Segunda Etapa

Depois que os rótulos foram adicionados, vamos alterar algumas

propriedades de cada controle. Na janela de propriedades, para
o primeiro Label vamos definir o texto “Nome” e a propriedade
“Name” vamos alterar para “lblNome” e segundo Label vamos
definir o texto como “Endereço” e nome “lblEndereco”.

PROGRAMAÇÃO PRÁTICA 25
3.2. TEXTBOX

Um componente TextBox também é chamado de Caixa de Texto.

É usado para permitir que um usuário insira informações textuais
como nome, endereço, peso, altura, etc.. Vamos ver como
podemos implementar isso com um exemplo mostrado abaixo.
Adicionaremos duas caixas de texto ao formulário, uma para o
nome e a outra para o endereço que vai ser inserido pelo usuário.

3.2.1. Primeira Etapa

A primeira etapa é arrastar da Toolbox dois componentes

“TextBox” para dentro do formulário, conforme mostrado na
imagem abaixo:

PROGRAMAÇÃO PRÁTICA 26
 3.2.2. Segunda Etapa

Depois que as caixas de texto forem adicionadas, vamos fazer

modificações na Janela de Propriedades. Para cada TextBox
alteraremos a propriedade “Name”. A primeira caixa de texto
deverá ter a propriedade “Name” definida como “txtNome” e
a segunda deverá ser definida como “txtEndereco”, conforme
imagem abaixo.

Imagem 13

PROGRAMAÇÃO PRÁTICA 27
3.3. ListBox

Uma ListBox ou Caixa de Listagem é usada para mostrar uma lista

de itens no formulário. Veremos como podemos implementar isso
com um exemplo mostrado abaixo. Adicionaremos uma caixa de
listagem ao formulário para armazenar alguns estados brasileiros.

3.3.1. Primeira Etapa

A primeira etapa é arrastar da "Toolbox"o controle "ListBox" para

dentro do formulário, conforme mostrado na Imagem abaixo:

PROGRAMAÇÃO PRÁTICA 28
3.3.2. SEGUNDA Etapa

Após a adição da “ListBox” ao formulário, acesse a “Janela de

Propriedades” clicando no controle como botão esquerdo dou
mouse, ou ainda, clicando com o botão direito e selecionando a opção
“Properties” no menu suspenso que é exibido (Imagem abaixo).

4 1

PROGRAMAÇÃO PRÁTICA 29
1º. Primeiro, altere a propriedade “Name” do controle, no nosso
caso, alteramos isso para "lstEstado";

2º. Clique na propriedade “Items”. Isso permitirá que você

adicione itens diferentes que podem aparecer na listagem do
componente. No nosso caso, clicaremos no botão representado
por “...”, quando clicamos sobre a opção "collection";

3º. No Editor de coleção exibido, insira os nomes dos estados.

No nosso caso, inserimos “Bahia”, "Rio de Janeiro", "Rio Grande
do Sul", "São Paulo" e “Santa Catarina”;

4º. Por fim, clique no botão “Ok”.

Depois de
aplicar as
alterações
acima, a ListBox
ficará conforme
mostrado na
Imagem 15:
Imagem 15

PROGRAMAÇÃO PRÁTICA 30
3.4. Radiobutton

Um RadioButton é usado quando existe um conjunto de valores

dos quais o usuário pode escolher apenas um. Vamos ver como
podemos implementar isso com um exemplo mostrado abaixo.
Adicionaremos dois RadioButtons para as opções "Ativo" e
"Inativo", que são dois valores possíveis em que o usuario poderá
escolher.

3.4.1. Primeira Etapa

A primeira etapa é arrastar da “Toolbox” dois controles “RadioButton”

para o formulário, como mostrado na imagem abaixo:

Imagem 13

PROGRAMAÇÃO PRÁTICA 31
3.4.2. SEGUNDA Etapa

Depois que os “RadioButtons” foram adicionados, será necessário

alterar as propriedades “Text” e “Name” de cada um.

1º. Primeiro, você precisa alterar a propriedade “Text” dos dois

controles. Acesse as propriedades de cada um e altere o texto
do primeiro “RadioButton” para “Ativo” e do segundo para
“Inativo”, conforme imagem abaixo.

PROGRAMAÇÃO PRÁTICA 32
2º. Da mesma forma, altere a propriedade “Name” dos dois
controles. Acesse a janela de propriedades de cada e altere o
nome do primeiro RadioButton para “rbtAtivo” e do segundo
para “rbtInativo”, conform é mostrado na imagem abaixo.

PROGRAMAÇÃO PRÁTICA 33
3.5. GroupBox

Um componente “GroupBox” é usado para criar um agrupamento

lógico em uma seção. Por exemplo, se você tiver uma coleção
de controles para inserir detalhes como nome e endereço de
uma pessoa. Idealmente, essas são informações relacionadas
a uma pessoa, portanto, você deve ter esses detalhes em uma
seção separada no formulário. Para esse fim, você pode ter um
GroupBox com este objetivo.

3.5.1. Primeira Etapa

A primeira etapa é arrastar o controle “Groupbox” da “Toolbox” para

dentro do formulário, como mostrado na imagem abaixo:

PROGRAMAÇÃO PRÁTICA 34
3.5.2. SEGUNDA Etapa

Depois que o “GroupBox” tiver sido adicionado, acesse as

propriedades do componente. Na janela de propriedades,
localize a propriedade “Text” e altere-a para "Informações do
Usuário" e a propriedade “Name” para “gpbInformacoes”.

PROGRAMAÇÃO PRÁTICA 35
3.6. Checkbox

Um componente "CheckBox" também é conhecido como Caixa

de seleção. É usada para fornecer algumas opções dentre
as quais o usuário pode escolher nenhuma, uma ou várias.
Vamos ver como podemos implementar isso com um exemplo
mostrado abaixo. Adicionaremos três caixas de seleção ao
nosso formulário. Essas caixas de seleção fornecerão opções ao
usuário para ele escolher se deseja aprender C#, C++ ou Python.

3.6.1. Primeira Etapa

A primeira etapa é arrastar da Toolbox três componentes “CheckBox”

para dentro do formulário, conforme mostrado na Imagem :

PROGRAMAÇÃO PRÁTICA 36
3.6.2. SEGUNDA Etapa

Depois que as caixas de seleção forem adicionadas, vamos fazer

modificações na Janela de Propriedades. Para cada TextBox
alteraremos as propriedades “Text” e “Name”. A primeira caixa de
seleção deverá ter a propriedade “Name” definida como “chkCSharp”
e “Text” definido como “C#”. Para o segundo componente, defina
“Name” como “chkCPlusPlus” e “Text” como “C++”. Finalmente,
para a terceira caixa de seleção defina “Name” como “chkPython” e
“Text” como “Python”, conforme mostrado na imagem abaixo.

PROGRAMAÇÃO PRÁTICA 37
3.7. BUTTON

Um componente "Button", ou Botão, é usado para permitir ao

usuário quando clicá-lo, iniciar algum processamento dentro do
formulário. Imagine que você precisa fazer a leitura de dados de uma
pessoa e somente após preencher todos os campos, estas devem
ser inseridas em um Banco de Dados. Neste caso você pode usar um
botão para executar a ação de guardá-las. Vamos ver como podemos
implementar isso com um exemplo mostrado abaixo. Adicionaremos
um botão simples chamado “Confirmar”, que pode ser usado pelo
usuário para processar determinadas ações no formulário.

3.7.1. Primeira Etapa

A primeira etapa é arrastar da Toolbox um componente “Button” para

dentro do formulário, conforme mostrado na Imagem .

PROGRAMAÇÃO PRÁTICA 38
3.7.2. SEGUNDA Etapa

Depois que o “Button” tiver sido adicionado, acesse as propriedades do

componente. Na janela de propriedades, localize a propriedade “Text” e
altere-a para "Confirmar" e a propriedade “Name” para “btnConfirmar”.

PROGRAMAÇÃO PRÁTICA 39
 4. PADRÕES DE
NomenclaturA

PROGRAMAÇÃO PRÁTICA
Para garantir a qualidade de qualquer sistema, temos um ponto bem
importante para definir no projeto, independente da quantidade de
desenvolvedores envolvidos. Este ponto refere-se à padronização.
Ela é uma forma de manter o código organizado e bem escrito. O
padrão é algo que deve ser definido pela equipe de desenvolvimento
antes do início do projeto e mantido durante o desenvolvimento,
mas o principal: todos devem seguir este padrão!

Especificamente, nesta seção vamos tratar sobre a padronização

da nomenclatura dos componentes que usamos para desenvolver
aplicações Windows Forms. Sempre que houver necessidade,
aplique nomes aos componentes. Para ser mais claro, nomeie os
componentes que você precisará referenciar no código. Sempre
adicione um nome significativo, conforme fizemos nos exemplos
deste eBook. Abaixo segue uma tabela com padrões de nomenclatura
de componentes que foram abordados na seção anterior.

Componente Prefixo Exemplo

Form frm frmPrincipal
Label lbl lblNome
TextBox txt txtEndereco
ListBox lst lstEstados
RadioButton rbt rbtAtivo
CheckBox chk chkIdioma
Button btn btnConfirmar

PROGRAMAÇÃO PRÁTICA 41
 PROGRAMAÇÃO PRÁTICA

Gilseone Moraes