Declaração de Macro de Submacro

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

A Submacro instrução no Access define uma macro separada na janela Designer Macro.

Configuração

A Submacro ação tem apenas um argumento necessário.

Argumento da ação Descrição
Name Uma cadeia de caracteres que aparece como o nome da macro.

Comentários

Você pode usar a Submacro instrução para definir conjuntos separados de ações. Você pode executar as ações definidas em submacros de outra macro usando a RunMacro ação. Macro Name No argumento da RunMacro ação, use a seguinte sintaxe para executar a submacro:

<macro name>.<submacro name>

Você também pode usar a Submacro instrução para definir um conjunto de ações de tratamento de erros em uma macro.

Exemplo

A macro a seguir demonstra a Submacro instrução junto com uma OnError ação de macro. Neste exemplo, a ação instrui o OnError Access a executar uma submacro personalizada de tratamento de erros nomeada ErrorHandler quando ocorre um erro. Se ocorrer um erro em qualquer das ações a seguir, o Access pulará para a ErrorHandler submacro. A ErrorHandler submacro exibe uma caixa de mensagem que faz referência ao MacroError objeto para mostrar informações sobre o erro.

Esta captura de tela mostra o exemplo anterior no designer de macros do Access. Nesse caso, a expressão na ação dispara um SetLocalVar erro porque tenta dividir um número por zero. O Access move para a submacro nomeada ErrorHandler e exibe as informações de erro em uma caixa de mensagem.

Superfície de design de macro do Access exibindo uma ação de macro AoOcorrerErro.