Acção de Macro LimparErroMacro

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.