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.
Aqui está uma captura de tela do designer de macro 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.