Méthode DoCmd.CancelEvent (Access)

La méthode CancelEvent exécute l’action Annulerévénement dans Visual Basic.

Syntaxe

expression. CancelEvent

expressionune variable représentant un objet DoCmd.

Remarques

Utilisez la méthode CancelEvent pour annuler l’événement qui a provoqué l’exécution par Microsoft Access de la procédure contenant cette méthode.

La méthode CancelEvent n'a d'effet que lorsqu'elle est exécutée en tant que résultat d'un événement. Cette méthode annule l'événement.

Dans un formulaire, l’action AnnulerEvénement est généralement utilisée dans une macro de validation avec la propriété de type événement AvantMAJ. Lorsqu'un utilisateur saisit des données dans un contrôle ou un enregistrement, Access exécute la macro avant d'ajouter les données dans la base de données. Si ces données échouent les conditions de validation de la macro, l'action CancelEvent annule le processus de mise à jour avant qu'il soit lancé.

Tous les événements qui peuvent être annulés en Visual Basic ont un argument Annuler . Utilisez cet argument au lieu de la méthode CancelEvent pour annuler l’événement. L’événement KeyPress et l’événement MouseDown (pour un clic droit uniquement) ne peuvent être annulés que dans les macros, et non dans les procédures événementielles. Vous devez donc utiliser l’action Annulerévénement dans une macro pour annuler ces événements.

Remarque

Utilisez la méthode CancelEvent avec l’événement MouseDown uniquement pour annuler l’événement qui se produit lorsque vous cliquez avec le bouton droit sur un objet.

Le comportement par défaut des événements pouvant être annulés (à savoir, le comportement d'Access lorsque l'événement est déclenché) a lieu une fois la procédure événementielle exécutée. Ceci vous permet d'annuler le comportement par défaut. Par exemple, lorsque vous double-cliquez sur un mot sur lequel se trouve le point d’insertion dans une zone de texte, Access sélectionne normalement ce mot. Vous pouvez, cependant, annuler ce comportement par défaut dans la procédure événementielle DblClick et exécuter une autre action comme l'ouverture d'un formulaire contenant des informations sur le contenu de la zone de texte. Le comportement par défaut des événements ne pouvant pas être annulés a lieu avant l'exécution de la procédure.

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.