Pode utilizar a ação de macro ExecutarMacro em bases de dados do Access para executar um macro. A macro pode estar num grupo de macros.
Utilize esta ação:
-
Para executar uma macro a partir de outra macro.
-
Para executar uma macro com base numa determinada condição.
-
Para anexar uma macro a um menu personalizado ou comando do friso.
Definição
A ação de macro ExecutarMacro tem os seguintes argumentos.
Argumento de ação |
Descrição |
Nome da Macro |
O nome da macro a executar. A caixa Nome da Macro na secção Argumentos de Ação da janela de estrutura da macro mostra todas as macros (e grupos de macros) na base de dados atual. Se a macro estiver num grupo de macros, é listada sob o nome do grupo de macros na lista como nome do grupo de macros.macroname. Este argumento é obrigatório. Se executar uma macro com a ação de macro ExecutarMacro num base de dados de biblioteca, Access procura a macro com este nome na base de dados da biblioteca e não a procura na base de dados atual. |
Repetir Contagem |
O número máximo de vezes que a macro será executada. Se deixar este argumento em branco (e o argumento Repetir Expressão também estiver em branco), a macro é executada uma vez. |
Repetir Expressão |
Uma expressão que avalia como Verdadeiro (–1) ou Falso (0). A macro deixa de ser executada se a expressão for avaliada como Falso. A expressão é avaliada sempre que a macro é executada. |
Observações
Se introduzir um nome de grupo de macros para o argumento Nome da Macro , o Access executa a primeira macro no grupo de macros.
Esta ação é semelhante a clicar em Executar Macro no separador Ferramentas da Base de Dados , selecionar uma macro e clicar em OK. No entanto, este comando executa a macro apenas uma vez, enquanto a ação de macro ExecutarMacro pode executar uma macro quantas vezes quiser.
Sugestões
Pode utilizar os argumentos Repetir Contagem e Repetir Expressão para determinar quantas vezes a macro é executada:
-
Se deixar ambos os argumentos em branco, a macro é executada uma vez.
-
Se introduzir um número para Contagem de Repetições , mas deixar Repetir Expressão em branco, a macro executa o número especificado de vezes.
-
Se deixar Repetir Contagem em branco, mas introduzir uma expressão para Expressão Repeat, a macro é executada até que a expressão seja avaliada como Falso.
-
Se introduzir valores para ambos os argumentos, a macro executa o número de vezes especificado em Contagem de Repetições ou até a Expressão repetida ser avaliada como Falso, o que ocorrer primeiro.
Quando executa uma macro que contém a ação de macro ExecutarMacro e chega à ação de macro ExecutarMacro , o Access executa a chamada macro. Quando a macro denominada estiver concluída, o Access regressa à macro original e executa a ação seguinte.
Notas:
-
Pode chamar uma macro no mesmo grupo de macros ou noutro grupo de macros.
-
Pode aninhar macros. Ou seja, pode executar a macro A, que por sua vez chama a macro B, etc. Em cada caso, quando a chamada macro estiver concluída, o Access regressa à macro que a chamou e executa a ação seguinte nessa macro.
Para executar a ação ExecutarMacro num módulo Visual Basic for Applications (VBA), utilize o método RunMacro do objeto DoCmd.