Método DoCmd.CancelEvent (Access)

O método CancelEvent realiza a ação CancelEvent no Visual Basic.

Sintaxe

expressão. Cancelarevento

expression Uma variável que representa um objeto DoCmd.

Comentários

Use o método CancelEvent para cancelar o evento que fez com que o Microsoft Access executasse o procedimento que contém esse método.

O método CancelEvent terá efeito somente quando for executado como resultado de um evento. Esse método cancela o evento.

Em um formulário, normalmente é usada a ação CancelarEvento em uma macro de validação com a propriedade de evento AntesDeAtualizar. Quando o usuário inserir dados em um controle ou registro, o Access executará a macro antes de adicionar os dados ao banco de dados. Se os dados falharem nas condições de validação da macro, a ação CancelEvent cancelará o processo de atualização antes dele ser iniciado.

Todos os eventos que podem ser cancelados no Visual Basic têm um argumento Cancelar . Use esse argumento em vez do método CancelEvent para cancelar o evento. O evento KeyPress e o evento MouseDown (somente para clicar com o botão direito do mouse) só podem ser cancelados em macros, não em procedimentos de evento, portanto, você deve usar a ação CancelEvent em uma macro para cancelar esses eventos.

Observação

Use o método CancelEvent com o evento MouseDown apenas para cancelar o evento que ocorre quando você clica com o botão direito do mouse em um objeto.

Para eventos que podem ser cancelados, o comportamento padrão do evento (ou seja, o que o Access geralmente faz quando ocorre um evento) acontece depois da execução do procedimento de evento. Isso permite cancelar o comportamento padrão. Por exemplo, quando você clica duas vezes em uma palavra sobre a qual está o ponto de inserção em uma caixa de texto, o Access normalmente seleciona a palavra. É possível cancelar esse comportamento padrão do procedimento para o evento DblClick e executar outra ação, como a abertura de um formulário que contém as informações dos dados na caixa de texto. Para eventos que não podem ser cancelados, o comportamento padrão ocorrerá antes da execução do procedimento.

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.