Compartilhar via


Método DoCmd.RunMacro (Access)

O método RunMacro executa a ação RunMacro no Visual Basic.

Sintaxe

expressão. RunMacro (MacroName, RepeatCount, RepeatExpression)

expression Uma variável que representa um objeto DoCmd.

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
MacroName Obrigatório Variantes Uma expressão de cadeia de caracteres que é o nome válido de uma macro no banco de dados atual. Se você executar código do Visual Basic que contenha o método RunMacro em um banco de dados biblioteca, o Microsoft Access procurará pela macro com esse nome no banco de dados biblioteca e não no banco de dados atual.
RepeatCount Opcional Variantes Uma expressão numérica avaliada como um número inteiro, que corresponde ao número de vezes que a macro será executada.
RepeatExpression Opcional Variantes Uma expressão numérica avaliada toda vez que a macro for executada. Quando avaliada como False (0), a macro interromperá a execução.

Comentários

Use o método RunMacro para executar uma macro.

Use MacroGroupName. Sintaxe macroName para o argumento MacroName para executar uma macro específica em um grupo de macros.

Se você especificar o argumento RepeatExpression e deixar o argumento RepeatCount em branco, deverá incluir a vírgula do argumento RepeatCount . Se você deixar um argumento à direita em branco, não use uma vírgula seguindo o último argumento especificado.

Exemplo

O exemplo a seguir executa a macro Imprimir Vendas que imprimirá o relatório de vendas duas vezes.

DoCmd.RunMacro "Print Sales", 2

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.