Applies ToAccess 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.

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.

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

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.

As comunidades ajudam você a fazer e responder perguntas, fazer comentários e ouvir especialistas com conhecimento avançado.