Como usar a instrução Option Explicit em VBA?

A instrução `Option Explicit` em VBA (Visual Basic for Applications) é uma prática recomendada que ajuda a evitar erros no código, exigindo que todas as variáveis sejam declaradas explicitamente antes de serem usadas. Isso significa que você deve declarar cada variável com `Dim`, `Private`, `Public`, ou `Static` antes de utilizá-la.

Para usar a instrução `Option Explicit`, você deve colocá-la no início do seu módulo de código, antes de qualquer procedimento ou declaração de variável. Aqui está um exemplo básico de como usar `Option Explicit`:

Option Explicit

Sub ExemploOptionExplicit()
    Dim contador As Integer
    Dim mensagem As String

    contador = 10
    mensagem = "O valor do contador é " & contador

    MsgBox mensagem
End Sub

Nesse exemplo, `contador` e `mensagem` são explicitamente declaradas antes de serem utilizadas no procedimento `ExemploOptionExplicit`.

Passos para usar `Option Explicit`:

  • Abrir o Editor do VBA:
    • No Excel, Word ou qualquer outro aplicativo do Microsoft Office que suporte VBA, pressione `ALT` + `F11` para abrir o Editor do VBA.
  • Inserir um Módulo ou Abrir um Existente:
    • Você pode adicionar um novo módulo clicando com o botão direito em `VBAProject` no painel à esquerda e selecionando `Inserir > Módulo`.
    • Ou, clique duas vezes em um módulo existente para abri-lo.
  • Adicionar `Option Explicit`:
    • Digite `Option Explicit` na primeira linha do módulo de código, antes de qualquer outra declaração.

Benefícios de Usar `Option Explicit`:

  • Prevenção de Erros: Reduz a possibilidade de erros devido a erros de digitação em nomes de variáveis.
  • Código Mais Claro e Legível: Ajuda a garantir que todas as variáveis utilizadas no código sejam devidamente documentadas e declaradas.
  • Facilidade de Depuração: Facilita o processo de depuração, já que será mais fácil identificar onde uma variável foi declarada ou se uma variável foi utilizada sem declaração.

Configuração Padrão:

Você pode configurar o VBA para sempre usar `Option Explicit` automaticamente em novos módulos. Para fazer isso:

  • No Editor do VBA, vá para `Ferramentas > Opções`.
  • Na aba `Editor`, marque a opção `Declaração de Variável Obrigatória`.

Com essa configuração, o VBA inserirá automaticamente `Option Explicit` no topo de cada novo módulo que você criar.

Unlock Your Potential

Excel

Basic - Advanced

Access

Access Basic - Advanced

Power BI

Power BI Basic - Advanced

Help us grow the project