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.