Sub-rotina Excel VBA: como chamar Sub em VBA com exemplo

Digamos que você criou uma interface de usuário com caixas de texto para aceitar dados de entrada do usuário. Você pode criar uma sub-rotina que limpe o conteúdo das caixas de texto. Uma sub-rotina de chamada VBA é apropriada nesse cenário porque você não deseja retornar nenhum resultado.

Por que usar sub-rotinas

• Divida o código em um pequeno código gerenciável: Um programa de computador médio possui milhares e milhares de linhas de código-fonte. Isso introduz complexidade. As sub-rotinas ajudam a resolver esse problema, dividindo o programa em pequenos pedaços de código gerenciáveis.
• Code capacidade de reutilização. Digamos que você tenha um programa que precisa acessar o banco de dados, quase todas as janelas do programa precisarão interagir com o banco de dados. Em vez de escrever código separado para essas janelas, você pode criar uma função que lide com todas as interações do banco de dados. Você pode então chamá-lo de qualquer janela que desejar.
• Sub-rotinas e funções são autodocumentadas. Digamos que você tenha uma função calculaLoanInterest e outra que diz connectToDatabase. Apenas olhando o nome da sub-rotina/função, o programador será capaz de dizer o que o programa faz.

Antes de escrever um nome, o compilador espera que ele siga um pequeno conjunto de regras.

Regras de nomenclatura de sub-rotinas e funções

Para usar sub-rotinas e funções, existem um conjunto de regras que devem ser seguidas.

• Uma sub-rotina ou nome de função de chamada VBA não pode conter espaço
• Uma subchamada VBA do Excel ou nome de função deve começar com uma letra ou sublinhado. Não pode começar com um número ou caractere especial
• Uma sub-rotina ou nome de função não pode ser uma palavra-chave. Uma palavra-chave é uma palavra que tem um significado especial em VBA. Palavras como Private, Sub, Function e End, etc. são exemplos de palavras-chave. O compilador os utiliza para tarefas específicas.

Com um nome válido escolhido, a própria declaração segue um padrão fixo.

Sintaxe de sub-rotina VBA

Você precisará habilitar a guia Desenvolvedor no Excel para acompanhar este exemplo. Se você não sabe como ativar a guia Desenvolvedor, leia o tutorial em Controles VBA no Excel

AQUI na sintaxe,

Private Sub mySubRoutine(ByVal arg1 As String, ByVal arg2 As String)
    'do something
End Sub

Explicação da sintaxe

A sub-rotina a seguir aceita o nome e o sobrenome e os exibe em uma caixa de mensagem.

Agora vamos programar e executar este Subprocedimento. Vamos ver isso.

Private Sub displayFullName(ByVal firstName As String, ByVal lastName As String)
    MsgBox firstName & " " & lastName
End Sub

Private Sub btnDisplayFullName_Click()
    displayFullName "John", "Doe"
End Sub

Um botão é conveniente, mas não é a única maneira de iniciar uma sub-rotina e, durante o desenvolvimento, raramente é a mais rápida.

Como executar uma sub-rotina sem um botão

Enquanto você ainda está escrevendo o código, adicionar um controle à planilha apenas para testar uma sub-rotina é uma perda de tempo. O VBA oferece quatro outras maneiras de executar uma sub-rotina, e cada uma delas se adequa a um momento diferente do ciclo de desenvolvimento.

• Pressione F5 no editor: Posicione o cursor em qualquer lugar dentro da Sub e pressione F5. Ela será executada imediatamente. Isso só funciona quando a Sub não recebe argumentos, pois o VBA não possui valores para serem fornecidos.
• Avance com F8: A mesma execução, linha por linha, para que você possa observar a alteração de cada variável na janela "Locais". Use este recurso quando um resultado estiver incorreto e você precisar identificar a causa.
• Utilize a caixa de diálogo Macros: Na guia Desenvolvedor, clique em Macros, selecione o nome e clique em Executar. Somente Subs públicas sem argumentos aparecem nesta lista, razão pela qual uma Sub auxiliar geralmente é declarada como Privada.
• Chame isso de outro Sub: Este é o método usado para qualquer Sub que receba argumentos, e é aquele em que o botão de comando acima se baseia.

A última opção possui duas formas aceitas. Escrever o nome seguido dos argumentos básicos funciona, assim como usar a palavra-chave `Call` explicitamente, mas a regra dos colchetes difere entre elas.

Sub RunTheGreeting()
    ' Form 1: no Call keyword, no brackets
    displayFullName "John", "Doe"

    ' Form 2: Call keyword, brackets required
    Call displayFullName("Jane", "Roe")
End Sub

Ambas as linhas fazem exatamente a mesma coisa. Misturar as duas formas, escrevendo colchetes sem a palavra-chave `Call`, é a causa mais comum do erro de compilação "Expected: =" quando uma `Sub` recebe mais de um argumento.

Diferença entre uma Sub e uma Função em VBA

Sub e Function são os dois tipos de procedimento em VBA, e iniciantes frequentemente escolhem o errado. A questão decisiva é simples: o código que chama o procedimento precisa de um valor de retorno?

Use uma Sub quando o código atuar na planilha e uma Função VBA Quando o código produz uma resposta que outra coisa consome.

Perguntas Frequentes