Compartir a través de


Método DoCmd.CancelEvent (Access)

El método CancelEvent lleva a cabo la acción CancelEvent en Visual Basic.

Sintaxis

expresión. Cancelarevento

expresión Variable que representa un objeto DoCmd.

Comentarios

Use el método CancelEvent para cancelar el evento que provocó que Microsoft Access ejecutara el procedimiento que contiene este método.

El método CancelEvent solo tiene efecto cuando se ejecuta como resultado de un evento. Este método cancela el evento.

En un formulario, suele usarse la acción CancelEvent en una macro de validación con la propiedad de evento BeforeUpdate. Cuando un usuario escribe datos en un control o en un registro, Access ejecuta la macro antes de agregar los datos a la base de datos. Si los datos no pasan las condiciones de validación de la macro, la acción CancelEvent cancela el proceso de actualización antes de que se inicie.

Todos los eventos que se pueden cancelar en Visual Basic tienen un argumento Cancel . Use este argumento en lugar del método CancelEvent para cancelar el evento. El evento KeyPress y el evento MouseDown (solo para el botón secundario) únicamente pueden cancelarse en macros, no en procedimientos de evento, con lo que debe usar la acción CancelEvent en una macro para cancelar estos eventos.

Nota:

Use el método CancelEvent con el evento MouseDown solo para cancelar el evento que se produce al hacer clic con el botón derecho en un objeto.

En el caso de los eventos que se pueden cancelar, el comportamiento predeterminado del evento (es decir, lo que Access suele hacer cuando se produce el evento) tiene lugar después de que se ejecute el procedimiento del evento. Esto permite cancelar el comportamiento predeterminado. Por ejemplo, al hacer doble clic en una palabra en la que se encuentra el punto de inserción en un cuadro de texto, Access normalmente selecciona la palabra. Puede cancelar este comportamiento predeterminado en el procedimiento del evento DblClick y realizar otra acción, como abrir un formulario que contenga información sobre los datos del cuadro de texto. En el caso de los eventos que no se pueden cancelar, el comportamiento predeterminado se produce antes de que se ejecute el procedimiento.

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.