Declaração de Macro de Submacro

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

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

Configuração

A ação Submacro tem apenas um argumento obrigatório.

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

Comentários

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

<nome da> macro.<nome da submacro>

Você também pode usar a política Submacro para definir um conjunto de ações de tratamento de erros em uma macro.

Exemplo

A macro a seguir demonstra o uso da instrução Submacro junto com uma ação de macro AoOcorrerErro. Neste exemplo, a ação AoOcorrerErro especifica que o Access deve executar uma submacro de tratamento de erros personalizada chamada ErrorHandler quando ocorre um erro. Se ocorrer um erro em qualquer uma das ações a seguir, o Access irá para a submacro ErrorHandler. A submacro ErrorHandler exibe uma caixa de mensagem que se refere ao objeto MacroError para exibir informações sobre o erro.

Eis uma captura de ecrã do estruturador de macros do Access com o exemplo anterior. Nesse caso, a expressão na ação DefinirVarLocal dispara um erro porque está tentando dividir um número por zero. O Access se move para baixo até a submacro chamada 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.