Editor VBA do Excel: Como Abrir e Usar (Aula 2)

Aula 2 — Conhecendo o Editor VBA do Excel. Nesta aula, você aprenderá a abrir o editor, identificar as principais janelas, inserir um módulo, executar um código e usar as ferramentas básicas de depuração. Ao final, conseguirá escrever e testar sua primeira macro com segurança.

Trilha gratuita de VBA: Índice do curso | ← Aula 1 — Introdução | Aula 3 — Primeira macro →

Existem milhares de sites que nos fornecem ou ensinam códigos prontos de macro VBA para usar no Excel. Mas, são raros aqueles que ensinam onde inserir esses códigos.

Portanto resolvi criar este artigo para você aprender o que é e como usar o editor de VBA do Excel.

O que é o editor de VBA do Excel

O VBE (Visual Basic Editor) é o ambiente de desenvolvimento do VBA (Visual Basic for Applications). É nele que você escreve, edita, organiza e testa procedimentos usados para automatizar tarefas no Excel. O VBE faz parte da versão do Excel para computador; o Excel para a Web não executa macros VBA.

Como abrir o Editor de VBA no Excel

A princípio existem 3 formas de se acessar ou abrir o Editor de VBA no Excel.

Atalho ALT F11

No Windows, pressione as teclas Alt + F11 juntas para abrir o Editor VBA. Em alguns notebooks, talvez seja necessário pressionar também Fn.

Automaticamente será aberta janela do VBE.

Na guia Desenvolvedor / Visual Basic

A segunda forma de se acessar o editor do VBA é acessando a guia Desenvolvedor e em seguida clicar no ícone Visual Basic.

No entanto, se a guia Desenvolvedor não aparecer no seu Excel acesse este link Como Encontrar e Inserir a Guia Desenvolvedor no Excel e veja como fazer com que apareça.

Pelo botão direito na guia da planilha

Outra forma é clicar com o botão direito na guia de uma planilha (por exemplo, Planilha1), na parte inferior do Excel, e escolher Exibir Código. Esse comando abre o VBE diretamente no módulo daquela planilha, usado principalmente para eventos. Para as macros comuns desta aula, crie um módulo padrão em Inserir > Módulo.

Estrutura do VBE

A estrutura do VBE é formada por várias partes internas conforme listado abaixo:

1. Barra de Menus
2. Barra de Ferramentas
3. Project Explorer
4. Janela de Verificação Imediata
5. Janela de Propriedades
6. Janela de Código
7. Janela Variáveis Locais
8. Janela Inspeção de Variáveis

1 – Barra de Menus

De maneira idêntica como em muitos programas como Word, Excel, Power Point, é bastante intuitiva.

Em outras palavras, nela você encontrará praticamente todas as configurações necessárias para formatar, inserir, editar o seu VBE.

2 – Barra de Ferramentas

Assim como a Barra de Menus, a Barra de Ferramentas contempla várias opções para editar nossos códigos, ou seja, temos desde o SALVAR até as configurações de propriedades do VBE.

3 – Project Explorer

O Project Explorer (Explorador de Projetos) mostra a estrutura dos projetos abertos no VBE: pastas de trabalho, planilhas, EstaPasta_de_trabalho ou ThisWorkbook, módulos e formulários. Os códigos ficam dentro desses componentes; para uma macro comum, geralmente usamos um módulo padrão.

Nesta janela, são guardados os Módulos, Formulários e Módulos de Classes.

4 – Janela de Verificação Imediata

A Janela de Verificação Imediata (Immediate Window) também é útil para iniciantes: permite testar expressões e ver mensagens enviadas pelo comando Debug.Print. No Windows, pressione Ctrl + G dentro do VBE para abri-la. Digite ? 2 + 3 e pressione Enter: deverá aparecer o resultado 5.

5 – Janela de Propriedades

A janela de Propriedades tem como função disponibilizar para o desenvolvedor formas de manipular as características de um objeto.

Nela você consegue mudar as cores, tamanhos e formas de objetos como botões, formulários, caixas de texto, etc.

6 – Janela de Código

A Janela de Código é onde todo o código VBA será exibido e desenvolvido.

Neste local o desenvolvedor criará suas macros e poderá visualizar todas as linhas em funcionamento.

Um projeto pode conter várias janelas de código, uma para cada módulo, planilha, formulário ou outro componente. Para abrir o código de um módulo, dê dois cliques nele no Explorador de Projetos.

7 – Janela Variáveis Locais

A Janela Variáveis Locais exibirá para o desenvolvedor as informações contidas nas variáveis como tipo e valor.

Como usar o editor de VBA do Excel

Agora que descrevemos cada janela do editor de VBA do Excel, vamos aprender como inserir um código.

Abra uma nova planilha de Excel e use o atalho ALT F11. Será aberto o VBE.

No Editor VBA, localize sua pasta de trabalho no Explorador de Projetos e clique em Inserir > Módulo no menu superior. Também é possível clicar com o botão direito no nome do projeto e selecionar Inserir > Módulo. Isso cria um módulo padrão, geralmente chamado Módulo1, onde ficará a macro.

Depois disso será aberta a Janela de Código. Aqui vamos inserir nosso primeiro código.

Digite ou copie o seguinte:

Sub Mensagem()
MsgBox "Olá Mundo!"
End Sub

Ficará assim.

Com o cursor dentro do procedimento Mensagem, pressione F5 no Editor VBA para executar. Aparecerá a mensagem Olá Mundo!. No Excel para Windows, você também pode usar Alt + F8, escolher Mensagem e clicar em Executar.

Você acabou de digitar e executar seu primeiro código VBA.

Antes de começar: Excel e segurança

Use o Excel instalado no computador, no Windows ou Mac, e crie uma pasta de trabalho vazia. O Excel para a Web não executa macros VBA. Nos exemplos abaixo, os atalhos são para Windows; alguns notebooks exigem também a tecla Fn. Faça os testes em arquivos próprios, não na única cópia de uma planilha importante.

Salve em Arquivo > Salvar como > Pasta de Trabalho Habilitada para Macro do Excel (*.xlsm). O formato .xlsx não armazena o projeto VBA. Nunca habilite macros de arquivos de origem desconhecida ou não confiável.

Entenda seu primeiro código: Olá Mundo

O exemplo Mensagem apresentado acima tem três instruções. Sub Mensagem() inicia um procedimento; MsgBox "Olá Mundo!" exibe uma caixa com a mensagem; e End Sub encerra a macro. Com o cursor dentro do procedimento, pressione F5 no VBE para executá-lo. No Excel, você também pode abrir Alt + F8, selecionar Mensagem e clicar em Executar.

Exercício prático: Janela Imediata e Debug.Print

A Janela Imediata mostra os resultados enviados pelo VBA sem precisar preencher células. No VBE para Windows, pressione Ctrl + G para abri-la. Insira o código a seguir no mesmo módulo padrão, abaixo do procedimento Mensagem. Ele soma dois números e apresenta o resultado de duas maneiras.

Sub TestarEditorVBA()
    Dim total As Long

    total = 10 + 5
    Debug.Print "Resultado: " & total
    MsgBox "O resultado é " & total
End Sub

1. No Editor VBA, posicione o cursor dentro de TestarEditorVBA e pressione F5.
2. A caixa exibida deve conter O resultado é 15.
3. Abra a Janela Imediata com Ctrl + G. Procure a mensagem Resultado: 15.
4. Altere a soma para total = 10 + 7, execute novamente e observe o resultado 17.

O que significa cada linha do código?

• Sub TestarEditorVBA() começa o procedimento que será executado.
• Dim total As Long declara uma variável inteira, usada para guardar o resultado.
• total = 10 + 5 calcula uma soma e armazena o valor na variável.
• Debug.Print envia texto e valores para a Janela Imediata.
• MsgBox abre uma janela de mensagem. O sinal & junta o texto ao valor da variável.
• End Sub marca o final do procedimento.

Depuração: executar linha por linha com F8

Depurar é acompanhar a execução para entender o que o código faz e identificar erros. Coloque o cursor dentro da macro TestarEditorVBA e pressione F8 para iniciar a execução passo a passo no VBE para Windows. A linha destacada indica a próxima instrução. Continue pressionando F8 para avançar.

Para interromper o código em uma linha escolhida, selecione-a e pressione F9 para criar um ponto de interrupção (breakpoint); pressione F9 novamente para removê-lo. Quando a execução estiver pausada, abra a janela Variáveis Locais pelo menu Exibir para acompanhar o valor de total. Você também pode digitar ? total na Janela Imediata durante a pausa para consultar o valor.

Soluções para problemas frequentes

Não consigo encontrar o Explorador de Projetos

No VBE para Windows, abra Exibir > Explorador de Projetos ou pressione Ctrl + R. Expanda o projeto correspondente à pasta de trabalho e procure a pasta Módulos.

O procedimento não aparece na lista de macros

Confirme que o procedimento foi criado em um módulo padrão, que começa com Sub NomeDaMacro() e não exige parâmetros. Procedimentos privados ou de eventos podem não aparecer na lista normal de macros.

Meu arquivo não preservou o código

O formato .xlsx não guarda macros VBA. Use .xlsm para manter os módulos e procedimentos salvos.

O Excel informa que as macros foram bloqueadas

O Excel tem controles de segurança que podem bloquear macros. Não desative essas proteções indiscriminadamente. Pratique com um arquivo criado por você e siga as políticas do seu computador ou organização.

Desafio da Aula 2

Crie, em um módulo padrão, uma macro chamada CalcularDobro. Declare uma variável Long, guarde nela o número 12, multiplique por 2 e mostre o resultado usando Debug.Print. O resultado esperado é 24 na Janela Imediata. Depois, execute com F8 para observar a mudança do valor.

Próxima aula: criando sua primeira macro gravada

Agora que você conhece as janelas do VBE e sabe executar código, siga para a Aula 3 — Criando sua primeira macro sem escrever código. Para revisar os demais conteúdos, veja o índice do Curso Gratuito de VBA.

Praticamente o uso do editor de VBA funciona desta forma. Você insere o código em um módulo e manda executar.

Há outras formas, como o uso de botões, cliques do mouse, etc. Mas, isso é assunto para outro artigo.

Espero que tenha esclarecido um pouco como usar o editor de VBA do Excel.

Deixo aqui meu fortíssimo abraço e até a próxima!