Acção de Macro LimparErroMacro

Pode utilizar a ação LimparErroMacro para limpar a informação sobre um erro que está armazenado no objeto ErroMacro.

Nota: A ação de macro LimparErroMacro não está disponível nas aplicações Web do Access.

Definição

A ação LimparErroMacro não possui quaisquer argumentos.

Observações

  • Quando ocorre um erro numa macro, as informações sobre o erro são armazenadas no objeto ErroMacro. Se não utilizou a ação AoOcorrerErro para suprimir mensagens de erro, a macro para e a informação do erro é apresentada numa mensagem de erro padrão. No entanto, se utilizou a ação AoOcorrerErro para suprimir as mensagens de erro, pode querer utilizar as informações armazenadas no objeto ErroMacro numa condição ou numa mensagem de erro personalizada.

    Depois de um erro ter sido resolvido, as informações no objeto ErroMacro ficam desatualizadas, portanto é uma boa ideia limpar o objeto ao utilizar a ação LimparErroMacro. A ação repõe o número de erro no objeto ErroMacro para 0 e limpa quaisquer outras informações sobre o erro que estejam armazenadas no objeto, como a descrição do erro, o nome da macro, o nome da ação, a condição e os argumentos. Desta forma, pode inspecionar o objeto ErroMacro novamente mais tarde para verificar se ocorreu outro erro.

  • O objeto ErroMacro é limpo automaticamente quando uma macro termina, portanto não necessita de utilizar a ação LimparErroMacro no fim de uma macro.

  • O objeto ErroMacro apenas contém informações sobre um erro de cada vez. Se tiver ocorrido mais do que um erro numa macro, o objeto ErroMacro apenas contém informações sobre o último erro.

  • Para executar a ação LimparErroMacro num módulo VBA, utilize o método LimparErroMacro do objeto DoCmd.

Exemplo

A seguinte macro utiliza a ação AoOcorrerErro com o argumento Seguinte para suprimir mensagens de erro e, em seguida, utiliza a ação AbrirFormulário para abrir o formulário. Para este exemplo, um erro é criado deliberadamente ao utilizar a ação IrParaRegisto para aceder ao registo anterior. A condição [ErroMacro].[Número]<>0 testa o objeto ErroMacro. Se tiver ocorrido um erro, o número de erro é diferente de zero e a ação CxMsg é executada. A caixa de mensagens apresenta o nome da ação que causou o erro (neste caso, a ação IrParaRegisto) e depois o número do erro. Por fim, executar a ação LimparErroMacro limpa o objeto ErroMacro.

Condição

Ação

Argumentos

AoOcorrerErro

Ir para: Seguinte

AbrirFormulário

Nome do Formulário CategoriaDoFormulário

Ver: Formulário

Modo de Janela: Normal

IrParaRegisto

Tipo de Objeto: Formulário

Nome do Objeto: CategoriaDoFormulário

Registo: Anterior

[ErroDeMacro].[Número]<>0

CxMsg

Mensagem: ="Erro # " & [ErroMacro].[Número] & " em " & [ErroMacro].[ActionName] & " ação."

AvisoSonoro: Sim

Tipo: Informações

LimparErroMacro

Aumente os seus conhecimentos do Office
Explore as formações
Seja o primeiro a obter novas funcionalidades
Adira ao Office Insider

As informações foram úteis?

Obrigado pelos seus comentários!

Obrigado pelo seu feedback! Parece que poderá ser benéfico reencaminhá-lo para um dos nossos agentes de suporte do Office.

×