A plataforma de programação VBA^{(VBA programming)} que funciona em quase todos os produtos Microsoft Office é uma das ferramentas mais poderosas que qualquer pessoa pode usar para aprimorar o uso desses produtos.

Este guia VBA para iniciantes mostrará como adicionar o menu Desenvolvedor ao seu aplicativo ^(Developer)do Office^(Office) , como entrar na janela do editor VBA e como as instruções e loops básicos do ^(VBA)VBA funcionam para que você possa começar a usar o VBA no Excel , Word , Powerpoint , Outlook e OneNote .

Este guia VBA usa a versão mais recente dos produtos Microsoft Office . Se você tiver uma versão anterior, poderá ver algumas pequenas diferenças nas capturas de tela.

Como habilitar e usar o editor VBA^{(How To Enable & Use The VBA Editor)}

Em qualquer um dos produtos do Office usados ​​neste guia, você pode perceber que não tem o menu do desenvolvedor referenciado. ^(Developer)O menu do desenvolvedor está disponível apenas no Excel , Word , Outlook e Powerpoint . O OneNote^(OneNote) não oferece uma ferramenta para editar código VBA de dentro do aplicativo, mas você ainda pode fazer referência à API do OneNote^{(OneNote API)} para interagir com o OneNote de outros programas do Office . 

Você aprenderá como fazer isso em nosso próximo guia VBA avançado^{(Advanced VBA)} .

• Para habilitar o menu Desenvolvedor em qualquer produto de escritório, selecione o menu ^(Developer)Arquivo^(File) e selecione Opções^(Options) no menu de navegação esquerdo. 
• Você verá um menu pop-up de opções . ^(Options)Selecione Personalizar Faixa^{(Customize Ribbon)} de Opções no menu de navegação à esquerda.

A lista à esquerda inclui todos os menus e comandos de menu disponíveis nesse aplicativo do Office^(Office) . A lista à direita são aqueles que estão atualmente disponíveis ou ativados.

• Você deverá ver Desenvolvedor^(Developer) na lista à direita, mas ele não será ativado. Basta^(Just) selecionar a caixa de seleção para ativar o menu Desenvolvedor .^(Developer)

• Se você não vir Desenvolvedor^(Developer) disponível à direita, altere o menu suspenso Escolher comandos à esquerda para ^{(Choose commands)}Todos os comandos^{(All Commands)} . Encontre Desenvolvedor^(Developer) na lista e selecione Add>> no centro para adicionar esse menu à Faixa^(Ribbon) de Opções .
• Selecione OK quando terminar.
• Quando o menu Desenvolvedor^(Developer) estiver ativo, você poderá voltar à janela principal do aplicativo e selecionar Desenvolvedor^(Developer) no menu superior. 
• Em seguida, selecione Exibir código^{(View Code)} no grupo controles^(Controls) na faixa de opções para abrir a janela do editor VBA .

• Isso abrirá a janela do editor VBA , onde você poderá digitar o código que aprenderá nas próximas seções.

• Tente adicionar o menu Desenvolvedor^(Developer) a alguns dos aplicativos do Office que você usa todos os dias. Quando estiver confortável para abrir a janela do editor VBA , continue para a próxima seção deste guia.

Dicas gerais de programação VBA para iniciantes^{(General VBA Programming Tips for Beginners)}

Você notará quando o editor VBA for^(VBA) aberto, as opções de navegação no painel esquerdo parecerão diferentes de um aplicativo do Office para outro.

Isso ocorre porque os objetos disponíveis onde você pode colocar o código VBA dependem de quais objetos existem no aplicativo. Por exemplo, no Excel , você pode adicionar código VBA a objetos de pasta de trabalho ou planilha. No Word , você pode adicionar código VBA aos documentos. ^(VBA)No Powerpoint , apenas para módulos.

Portanto, não se surpreenda com os diferentes menus. A estrutura e a sintaxe do código VBA são as mesmas em todos os aplicativos. ^(VBA)A única diferença são os objetos que você pode referenciar e as ações que você pode realizar nesses objetos por meio do código VBA .

Antes de nos aprofundarmos nos diferentes objetos e ações que você pode executar neles por meio do código VBA , vamos primeiro examinar a estrutura e a sintaxe ^(VBA)VBA mais comuns que você pode usar ao escrever o código VBA .

Onde colocar o código VBA^{(Where To Put VBA Code)}

Quando estiver no editor VBA , você precisa usar as duas caixas suspensas na parte superior da janela de edição para escolher a qual objeto deseja anexar o código e quando deseja que o código seja executado.

Por exemplo, no Excel , se você escolher Planilha^(Worksheet) e Ativar^(Activate) , o código será executado sempre que a planilha for aberta. 

Outras ações de planilha que você pode usar para acionar seu código VBA incluem quando a planilha é alterada, quando é fechada (desativada), quando o cálculo da planilha é executado e muito mais.

Ao adicionar código VBA no editor, sempre certifique-se de colocar seu código VBA no objeto e usar a ação correta que deseja usar para acionar esse código.

Declarações IF VBA^{(VBA IF Statements)}

Uma instrução IF funciona no VBA da mesma forma que funciona em qualquer outra linguagem de programação.

A primeira parte da instrução IF verifica se uma condição ou conjunto de condições é verdadeiro. Essas condições podem ser unidas por um operador AND ou OR para vinculá-las.

Um exemplo seria verificar se uma nota em uma planilha está acima ou abaixo de uma nota de “aprovação” e atribuir o status de aprovação ou reprovação a outra célula.

If Cells(2, 2) > 75 Then Cells(2, 3) = “Pass” Else Cells(2, 3) = “Fail”

Se você não quiser a instrução inteira em uma única linha, você pode dividi-la em várias linhas adicionando um símbolo “_” no final das linhas.

If Cells(2, 2) > 75 Then _
Cells(2, 3) = “Pass”  Else _
Cells(2, 3) = “Fail”

Usar essa técnica geralmente pode tornar o código muito mais fácil de ler e depurar.

VBA para próximos loops^{(VBA For Next Loops)}

As instruções IF são ótimas para comparações simples, como o exemplo acima de olhar para uma única célula. Mas e se você quiser percorrer um intervalo inteiro de células e fazer a mesma instrução IF em cada uma delas?

Nesse caso, você precisaria de um loop  FOR .

Para fazer isso, você precisa usar o comprimento de um intervalo e percorrer esse comprimento pelo número de linhas que contêm dados.

Para fazer isso, você precisa definir o intervalo e as variáveis ​​de célula e percorrê-las. Você também precisará definir um contador para poder enviar os resultados para a linha apropriada. Portanto, seu código VBA primeiro teria essa linha.

Dim rng As Range, cell As Range
Dim rowCounter as Integer

Defina o tamanho do intervalo da seguinte forma. 

Set rng = Range(“B2:B7”)
rowCounter = 2

Finalmente, você pode criar seu loop FOR para percorrer todas as células nesse intervalo e fazer a comparação.

For Each cell In rng
   If cell.Value > 75 Then _
   Cells(rowCounter, 3) = "Pass" Else _
   Cells(rowCounter, 3) = "Fail"

   rowCounter = rowCounter + 1

Next cell

Depois que esse script VBA^{(VBA script)} for executado, você verá os resultados na planilha real.

VBA While Loops

Um loop while também percorre uma série de instruções, assim como o loop FOR , mas a condição do loop para continuar é uma condição que permanece verdadeira.

Por exemplo, você pode escrever o mesmo loop FOR acima, como um loop WHILE , simplesmente usando a variável rowCounter da seguinte maneira.

While rowCounter < rng.Count + 2
   If Cells(rowCounter, 2) > 75 Then _
   Cells(rowCounter, 3) = "Pass" Else _
   Cells(rowCounter, 3) = "Fail"
   rowCounter = rowCounter + 1
Wend

Observação: o limite de terminação rng.Count + 2 é necessário porque o contador de linhas começa em 2 e precisa terminar na linha 7, onde os dados terminam. No entanto, a contagem do intervalo (B2:B7) é apenas 6, e o loop While só terminará quando o contador for MAIOR^(GREATER) que o contador – portanto, o último valor de rowCounter precisa ser 8 (ou rng.Count + 2).

Você também pode configurar o loop While da seguinte forma:

While rowCounter <= rng.Count + 1

Você só pode incrementar a contagem do intervalo (6) em 1, pois assim que a variável rowCounter atingir o final dos dados (linha 7), o loop pode terminar.

VBA Do While e Do Until Loops^{(VBA Do While and Do Until Loops)}

Os loops Do While e Do Until são quase idênticos aos loops While, mas funcionam um pouco diferente.

• O While Loop verifica se uma condição é verdadeira no início do loop.
• O Do-While Loop verifica se uma condição é verdadeira após a execução das instruções no loop.
• O Do-Until Loop verifica se uma condição ainda é falsa após a execução do loop.

Nesse caso, você reescreveria o loop While acima da seguinte forma, como um loop Do-While.

Do
   If Cells(rowCounter, 2) > 75 Then _
   Cells(rowCounter, 3) = "Pass" Else _
   Cells(rowCounter, 3) = "Fail"
   
   rowCounter = rowCounter + 1
Loop While rowCounter < rng.Count + 2

Nesse caso, a lógica não muda muito, mas se você quiser garantir que a comparação lógica ocorra depois que todas as instruções forem executadas (permitindo que todas sejam executadas, não importa o que pelo menos uma vez), então um Do-While ou Do-Until é a opção certa.

Declarações de caso de seleção do VBA^{(VBA Select Case Statements)}

O tipo final de instrução lógica que você precisa entender para começar a estruturar seu código VBA são instruções ^(VBA)Select Case .

Dado o exemplo acima, digamos que você queira ter um método de avaliação que não seja apenas pass-fail. Em vez disso, você deseja atribuir uma nota de letra de A a F.

Você pode fazer isso com a seguinte instrução Select Case :

For Each cell In rng
   
   Select Case cell

   Case 95 To 100
      Cells(rowCounter, 3) = "A"
   Case 85 To 94
      Cells(rowCounter, 3) = "B"
   Case 75 To 84
      Cells(rowCounter, 3) = "C"
   Case 65 To 74
      Cells(rowCounter, 3) = "D"
   Case 0 To 64
      Cells(rowCounter, 3) = "F"
   End Select

   rowCounter = rowCounter + 1

Next cell

A planilha resultante após a execução desse script VBA se parece com a abaixo.

Agora você sabe tudo o que precisa saber para começar a usar o VBA em seus aplicativos do Microsoft Office^{(Microsoft Office)} .

The Best VBA Guide (For Beginners) You’ll Ever Need

The VBA programming platform that runs throughout nearly all Microsoft Office products is one of the most powerful tools anyone can use to enhance their use of those products.

This VBA guide for beginners will show you how to add the Developer menu to your Office application, how to enter the VBA editor window, and how basic VBA statements and loops work so that you can get started using VBA in Excel, Word, Powerpoint, Outlook, and OneNote.

This VBA guide uses the latest version of Microsoft Office products. If you have an earlier version you may see some slight differences from the screenshots.

How To Enable & Use The VBA Editor

In any of the Office products used in this guide, you may notice that you don’t have the referenced Developer menu. The developer menu is only available in Excel, Word, Outlook, and Powerpoint. OneNote doesn’t offer a tool to edit VBA code from inside the application, but you can still reference the OneNote API to interact with OneNote from other Office programs. 

You’ll learn how to do this in our upcoming Advanced VBA guide.

• To enable the Developer menu in any office product, select the File menu, and select Options from the left navigation menu. 
• You’ll see an Options menu pop-up. Select Customize Ribbon from the left navigation menu.

The left list includes all available menus and menu commands available in that Office application. The list on the right are those that are currently available or activated.

• You should see Developer in the list on the right, but it will not be activated. Just select the checkbox to activate the Developer menu.

• If you don’t see Developer available on the right, then change the left Choose commands from dropdown to All Commands. Find Developer from the list and select Add>> in the center to add that menu to the Ribbon.
• Select OK when you’re done.
• Once the Developer menu is active, you can go back to your main application window and select Developer from the top menu. 
• Then select View Code from the Controls group in the ribbon to open the VBA editor window.

• This will open the VBA editor window where you can type the code you’ll learn in the next few sections.

• Try adding the Developer menu to a few of the Office applications you use every day. Once you’re comfortable opening the VBA editor window, continue on to the next section of this guide.

General VBA Programming Tips for Beginners

You’ll notice when the VBA editor opens, the navigation options in the left panel look different from one Office application to the other.

This is because the available objects where you can place VBA code depend on what objects there are in the application. For example, in Excel, you can add VBA code to workbook or sheet objects. In Word, you can add VBA code to documents. In Powerpoint, only to modules.

So, don’t be surprised by the different menus. The structure and syntax of the VBA code is the same across all applications. The only difference are the objects you can reference and the actions you can take on those objects through the VBA code.

Before we dive into the different objects and actions you can take on them via VBA code, let’s first look at the most common VBA structure and syntax you can use when you write VBA code.

Where To Put VBA Code

When you’re in the VBA editor, you need to use the two dropdown boxes at the top of the editing window to choose which object you want to attach the code to, and when you want the code to run.

For example, in Excel, if you choose Worksheet and Activate, the code will run whenever the worksheet is opened. 

Other worksheet actions you can use to trigger your VBA code include when the worksheet changes, when it’s closed (deactivated), when the worksheet calculation is run, and more.

When you add VBA code in the editor, always make sure to place your VBA code on the object and using the correct action that you want to use to trigger that code.

VBA IF Statements

An IF statement works in VBA just like it works in any other programming language.

The first part of the IF statement looks at whether a condition or set of conditions is true. These conditions can be joined by an AND or OR operator to link them together.

One example would be to check if a grade in a spreadsheet is above or below a “passing” grade, and assigning the pass or fail status to another cell.

If Cells(2, 2) > 75 Then Cells(2, 3) = “Pass” Else Cells(2, 3) = “Fail”

If you don’t want the entire statement on a single line, you can split it into multiple lines by adding a “_” symbol at the end of the lines.

If Cells(2, 2) > 75 Then _
Cells(2, 3) = “Pass”  Else _
Cells(2, 3) = “Fail”

Using this technique can often make code much easier to read and debug.

VBA For Next Loops

IF statements are great for single comparisons, like the example above of looking at a single cell. But what if you want to loop through an entire range of cells and do the same IF statement on each?

In this case you’d need a FOR loop. 

To do this, you’d need to use the length of a range, and loop through that length by the number of rows that contain data.

To do this, you need to define the range and cell variables, and loop through them. You’ll also need to define a counter so you can output the results to the appropriate row. So your VBA code would first have this line.

Dim rng As Range, cell As Range
Dim rowCounter as Integer

Define the range size as follows. 

Set rng = Range(“B2:B7”)
rowCounter = 2

Finally, you can create your FOR loop to step through every cell in that range and do the comparison.

For Each cell In rng
   If cell.Value > 75 Then _
   Cells(rowCounter, 3) = "Pass" Else _
   Cells(rowCounter, 3) = "Fail"

   rowCounter = rowCounter + 1

Next cell

Once this VBA script is run, you see the results in the actual spreadsheet.

VBA While Loops

A While Loop also loops through a series of statements, just like the FOR loop, but the condition of the looping to continue is a condition remaining true.

For example, you could write the same FOR loop above, as a WHILE loop, by simply using the rowCounter variable as follows.

While rowCounter < rng.Count + 2
   If Cells(rowCounter, 2) > 75 Then _
   Cells(rowCounter, 3) = "Pass" Else _
   Cells(rowCounter, 3) = "Fail"
   rowCounter = rowCounter + 1
Wend

Note: the rng.Count + 2 terminating limit is required because the row counter starts at 2 and needs to end on row 7 where the data ends. However, the count of the range (B2:B7) is only 6, and the While loop will only end once the counter is GREATER than the counter – so the last rowCounter value needs to be 8 (or rng.Count + 2).

You could also set up the While loop as follows:

While rowCounter <= rng.Count + 1

You can only increment the range count (6) by 1, because once the rowCounter variable reaches the end of the data (row 7), the loop can finish.

VBA Do While and Do Until Loops

Do While and Do Until loops are nearly identical to While loops, but work slightly different.

• The While Loop checks whether a condition is true at the beginning of the loop.
• The Do-While Loop checks whether a condition is true after executing the statements in the loop.
• The Do-Until Loop checks whether a condition is still false after executing the loop.

In this case you would rewrite the While loop above as follows, as a Do-While loop.

Do
   If Cells(rowCounter, 2) > 75 Then _
   Cells(rowCounter, 3) = "Pass" Else _
   Cells(rowCounter, 3) = "Fail"
   
   rowCounter = rowCounter + 1
Loop While rowCounter < rng.Count + 2

In this case the logic doesn’t change very much, but if you want to make sure the logic comparison takes place after all of the statements are run (allowing them all to run no matter what at least once), then a Do-While or Do-Until loop is the right option.

VBA Select Case Statements

The final type of logical statement you’ll need to understand to start structuring your VBA code are Select Case statements.

Given the example above, let’s say you want to have a grading method that isn’t just pass fail. Instead, you want to assign a letter grade from A through F.

You could do this with the following Select Case statement:

For Each cell In rng
   
   Select Case cell

   Case 95 To 100
      Cells(rowCounter, 3) = "A"
   Case 85 To 94
      Cells(rowCounter, 3) = "B"
   Case 75 To 84
      Cells(rowCounter, 3) = "C"
   Case 65 To 74
      Cells(rowCounter, 3) = "D"
   Case 0 To 64
      Cells(rowCounter, 3) = "F"
   End Select

   rowCounter = rowCounter + 1

Next cell

The resulting spreadsheet after this VBA script runs looks like the one below.

Now you know everything you need to know to start using VBA in your Microsoft Office applications.

Related posts

• Um guia avançado de VBA para MS Excel

• Os 13 melhores atalhos de teclado para o Microsoft Teams

• Como criar uma macro ou script VBA no Excel

• O que é o Microsoft Publisher? Um guia para iniciantes

• Como corrigir erro de marcador não definido no Word

• Como inserir um GIF animado no PowerPoint

• Como corrigir o Outlook preso ao carregar o perfil

• Corrigir erro de incompatibilidade de tag de início de tag final ao abrir arquivos DOCX

• Como corrigir erros #N/A em fórmulas do Excel como PROCV

• O que é o Microsoft Teams e como funciona?

• Como adicionar números de slides a uma apresentação do PowerPoint

• Como configurar recibos de leitura no Outlook

• Como remover bordas de tabela no Google Docs

• Como usar instruções if e if aninhadas no Excel

• 7 alternativas ao PowerPoint que você pode usar online

• Como reparar qualquer versão do Microsoft Office

• O Microsoft Outlook não abre? 10 maneiras de corrigir

• Como excluir uma página no Microsoft Word

• Como criar documentos PDF no Microsoft Office

• Como classificar por data no Excel