Aplica-se a
Access para Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

Você pode usar a ação de macro RunMacro nos bancos de dados access para executar um macro. A macro pode estar em um grupo de macros.

Use esta ação:

  • Para executar uma macro de dentro de outra macro.

  • Para executar uma macro com base em uma determinada condição.

  • Para anexar uma macro a um menu personalizado ou comando de faixa de opções.

Configuração

A ação de macro RunMacro tem os seguintes argumentos.

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 da janela de design 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. Esse é um argumento obrigatório.

Se você executar uma macro que contém a ação macro RunMacro em um banco de dados biblioteca, Access procurará a macro com esse nome no banco de dados da biblioteca e não a procurará no banco de dados atual.

Repetir Contagem

O número máximo de vezes que a macro será executada. Se você deixar esse argumento em branco (e o argumento Repetir Expressão também estiver em branco), a macro será executada uma vez.

Repetir expressão

Um expressão que avalia como True (-1) ou False (0). A macro para de ser executada se a expressão for avaliada como False. A expressão é avaliada sempre que a macro é executada.

Comentários

Se você inserir um nome de grupo de macro para o argumento Nome da Macro , o Access executará a primeira macro no grupo de macros.

Essa ação é semelhante a clicar em Executar Macro na guia Ferramentas de Banco de Dados , selecionar uma macro e clicar em OK. No entanto, esse comando executa a macro apenas uma vez, enquanto a ação macro RunMacro pode executar uma macro quantas vezes quiser.

Dicas

Você pode usar os argumentos Contagem de Repetição e Repetição de Expressão para determinar quantas vezes a macro é executada:

  • Se você deixar ambos os argumentos em branco, a macro será executada uma vez.

  • Se você inserir um número para Contagem de Repetição , mas deixar a Expressão De Repetição em branco, a macro executará o número especificado de vezes.

  • Se você deixar a Contagem de Repetição em branco, mas inserir uma expressão para Expressão deepeat R, a macro será executada até que a expressão seja avaliada como False.

  • Se você inserir valores para ambos os argumentos, a macro executará o número de vezes especificado em Contagem de Repetição ou até que a Expressão de Repetição seja avaliada como False, o que ocorrer primeiro.

Quando você executa uma macro que contém a ação macro RunMacro e ela atinge a ação macro RunMacro , o Access executa a chamada macro. Quando a macro chamada for concluída, o Access retornará à macro original e executará a próxima ação.

Observações: 

  • Você pode chamar uma macro no mesmo grupo de macros ou em outro grupo de macros.

  • Você pode aninhar macros. Ou seja, você pode executar a macro A, que por sua vez chama a macro B e assim por diante. Em cada caso, quando a macro chamada for concluída, o Access retorna à macro que a chamou e executa a próxima ação nessa macro.

Para executar a ação RunMacro em um módulo de Visual Basic for Applications (VBA), use o método RunMacro do objeto DoCmd.

Precisa de mais ajuda?

Quer mais opções

Explore os benefícios da assinatura, procure cursos de treinamento, saiba como proteger seu dispositivo e muito mais.