Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplica-se ao: Access 2013, Office 2013
Você pode usar a ação ExecutarMacro para executar uma macro. A macro pode estar em um grupo de macros.
Você pode usar a ação:
Para executar uma macro em outra macro.
Executar uma macro baseada em uma determinada condição.
Anexar uma macro a um comando de menu personalizado.
Setting
A ação ExecutarMacro tem os argumentos a seguir.
Argumento da ação |
Descrição |
|---|---|
Nome da Macro |
O nome da macro a ser executada. A caixa Nome da Macro na seção Argumentos de Ação do painel Construtor de Macro mostra todas as macros (e grupos de macro) no banco de dados atual. Se a macro estiver em um grupo de macros, ela será listada no nome do grupo de macros na lista como macrogrupo.macroname. Este é um argumento obrigatório. Se você executar uma macro contendo a ação ExecutarMacro em um banco de dados biblioteca, o Microsoft Access pesquisará a macro com esse nome no banco de dados biblioteca, e não no banco de dados atual. |
Contagem de repetição |
O número máximo de vezes que a macro será executada. Se você deixar este argumento em branco (e o argumento Expressão de repetição também estiver em branco), a macro será executada uma única vez. |
Expressão de repetição |
Uma expressão que avalia se True (–1) ou False (0). A execução da macro será interrompida se a expressão avaliar como False. A expressão é avaliada sempre que a macro é executada. |
Comentários
Se você inserir um nome de grupo de macros para o argumento Nome da macro, o Access executará a primeira macro do grupo.
Esta ação é semelhante a clicar em Executar Macro na guia Ferramentas de Banco de Dados, selecionar uma macro e clicar em OK. Entretanto, esse comando executa a macro uma única vez, ao passo que a ação ExecutarMacro pode executar uma macro quantas vezes você quiser.
Dica
[!DICA] Use os argumentos Contagem de repetição e Expressão de repetição para determinar quantas vezes a macro deve ser executada:
- Se você deixar os dois argumentos em branco, a macro será executada uma única vez.
- Se você inserir um número em Contagem de repetição, mas deixar Expressão de repetição em branco, a macro será executada pelo número de vezes especificado.
- Se você deixar Contagem de repetição em branco, mas inserir uma expressão em Expressão de repetição, a macro será executada até que a expressão avalie como False.
- Se você inserir valores para os dois argumentos, a macro será executada pelo número de vezes especificado em Contagem de repetição ou até que Expressão de repetição avalie como False, o que ocorrer primeiro.
Se uma macro contendo a ação ExecutarMacro for executada e ela alcançar a ação ExecutarMacro, o Access executará a macro chamada. Após a conclusão da macro chamada, o Access retornará à macro original e executará a próxima ação.
Observação
- É possível chamar uma macro do mesmo grupo de macros ou de outro grupo.
- Você pode aninhar macros. Ou seja, você pode executar a macro A que, por sua vez, chama a macro B etc. Em cada caso, quando a macro chamada é concluída, o Access retorna à macro que a chamou e executa a próxima ação dessa macro.
Para executar a ação ExecutarMacro em um módulo do VBA(Visual Basic for Applications), use o método RunMacro do objeto DoCmd.