Ação de macro CancelarEvento

Importante :  Este artigo foi traduzido por um sistema de tradução automática, leia o aviso de isenção de responsabilidade. Para sua referência, veja a versão em inglês deste artigo aqui.

Você pode usar a ação CancelarEvento para cancelar o evento que causou Access executar o macro contendo esta ação. O nome da macro é a configuração de uma propriedade de evento como BeforeUpdate, OnOpen, OnUnloadou AoImprimir.

Observação : A ação de macro CancelarEvento não está disponível no Access web apps.

Configuração

A ação CancelarEvento não tem argumentos.

Comentários

Em um formulário, normalmente você usar a ação CancelarEvento em uma macro validação com a propriedade de evento BeforeUpdate . Quando um usuário insere dados em uma controle ou registro, o Access executa a macro antes de adicionar os dados no banco de dados. Se os dados não às condições de validação na macro, a ação CancelarEvento cancelará o processo de atualizar antes de iniciar.

Muitas vezes, você use esta ação com a ação CaixaDeMensagem para indicar que os dados falhou às condições de validação e para fornecer informações úteis sobre o tipo de dados que devem ser inseridos.

Os seguintes eventos podem ser cancelados pela ação CancelarEvento .

AplicarFiltro

Dirty

MouseDown

BeforeDelConfirm

Sair

Relatório não contém

BeforeInsert

Filtro

Abrir

BeforeUpdate

Formato

Imprimir

DblClick

Pressionamento de tecla

Descarregar

Excluir


Observação : Você pode usar a ação CancelarEvento com o evento MouseDown somente para cancelar o evento que ocorre quando você clica um objeto.

Se a configuração de propriedade de evento de OnDblClick de um controle especificar uma macro que contém a ação CancelarEvento , a ação cancelará o evento DblClick .

Para eventos que podem ser cancelados, o comportamento padrão para o evento (ou seja, o Access normalmente faz quando o evento ocorre) ocorre depois da execução da macro para o evento. Isso permite cancelar o comportamento padrão. Por exemplo, quando você clica duas vezes uma palavra que se encontra o ponto de inserção em um caixa de texto, o Access normalmente seleciona a palavra. Você pode cancelar esse comportamento padrão na macro para o evento DblClick e executar outra ação, como abrir um formulário que contém informações sobre os dados na caixa de texto. Para eventos que não podem ser cancelados, o comportamento padrão ocorre antes da execução da macro.

Observação : Se a propriedade de evento AoDescarregar de um formulário especificar uma macro que executa uma ação CancelarEvento , você não conseguirá fechar o formulário. Você deve corrigir a condição que fez a ação CancelarEvento ser executada ou abrir a macro e exclua a ação CancelarEvento . Se o formulário é um janela restrita, você não poderá abrir a macro.

Para executar a ação CancelarEvento em um módulo Visual Basic for Applications (VBA), use o método CancelarEvento do objeto DoCmd .

Exemplo

Validar dados usando uma macro

A macro de validação a seguir verifica os códigos postais inseridos em um formulário fornecedores. Ela mostra o uso das PararMacro, CaixaDeMensagem, CancelarEventoe IrParaControle ações. Uma expressão condicional verifica o país/região e o código postal inseridos em um registro no formulário. Se o código postal não estiver no formato correto para o país/região, a macro exibe uma caixa de mensagem e salvará o registro. Ele, em seguida, retorna ao controle CEP, onde você pode corrigir o erro. Essa macro deve ser anexada à propriedade AntesDeAtualizar do formulário fornecedores.

Condição

Ação

Argumentos: configuração

Comentário

IsNull([CountryRegion])

PararMacro

Se Paísregião for Nulo, CEP não pode ser validado.

[Paísregião] Em ("França", "Itália", "Espanha") And Len ([CEP]) <> 5

MsgBox

Mensagem: O CEP deve ter 5 caracteres.

AlarmeSonoro: Sim

Informações do tipo:

Título: Erro de código Postal

Se o código postal não 5 caracteres, exibe uma mensagem.

...

CancelarEvento

Cancele o evento.

IrParaControle

Nome do controle: CEP

[Paísregião] Em ("Austrália", "Cingapura") e Compr ([CEP]) <> 4

MsgBox

Mensagem: O código postal deve ter 4 caracteres.

AlarmeSonoro: Sim

Informações do tipo:

Título: Erro de código Postal

Se o código postal não 4 caracteres, exibe uma mensagem.

...

CancelarEvento

Cancele o evento.

IrParaControle

Nome do controle: CEP

([Paísregião] = "Canadá") E ([CEP] não como "[A-Z] [0-9] [A-Z] [0-9][A-Z][0-9]")

MsgBox

Mensagem: O código postal não é válido. Exemplo de código canadense: H1J 1C3

AlarmeSonoro: Sim

Informações do tipo:

Título: Erro de código Postal

Se o código postal não estiver correto para o Canadá, exibe uma mensagem. (Exemplo de código canadense: H1J 1C3)

...

CancelarEvento

Cancele o evento.

Observação : Aviso de Isenção de Tradução Automática: Este artigo foi traduzido por computador, sem intervenção humana. A Microsoft oferece essas traduções automáticas para ajudar as pessoas que não falam inglês a aproveitar os textos escritos sobre produtos, serviços e tecnologias da Microsoft. Como este artigo foi traduzido automaticamente, é possível que contenha erros de vocabulário, sintaxe ou gramática.

Expanda suas habilidades
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×