DoCmd.CancelEvent-Methode (Access)

Die CancelEvent-Methode führt die CancelEvent-Aktion in Visual Basic aus.

Syntax

Ausdruck. Abbrechenereignis

expression Eine Variable, die ein DoCmd-Objekt darstellt.

HinwBemerkungeneise

Verwenden Sie die CancelEvent-Methode , um das Ereignis abzubrechen, durch das Microsoft Access die Prozedur mit dieser Methode ausgeführt hat.

Die CancelEvent-Methode wirkt sich nur aus, wenn sie als Ergebnis eines Ereignisses ausgeführt wird. Mit dieser Methode wird die Ausführung des Ereignisses abgebrochen.

In einem Formular können Sie in der Regel die CancelEvent-Aktion in einem Gültigkeitsprüfungsmakro mit der BeforeUpdate-Ereigniseigenschaft verwenden. Wenn ein Benutzer in einem Steuerelement oder einem Datensatz Daten eingibt, wird das Makro in Access ausgeführt, bevor die Daten der Datenbank hinzugefügt werden. Wenn die Daten die Validierungsbedingungen im Makro nicht erfüllen, wird der Aktualisierungsprozess mit der CancelEvent-Aktion unterbrochen, bevor er gestartet werden kann.

Alle Ereignisse, die in Visual Basic abgebrochen werden können, verfügen über ein Cancel-Argument . Verwenden Sie dieses Argument anstelle der CancelEvent-Methode , um das Ereignis abzubrechen. Das KeyPress-Ereignis und das MouseDown-Ereignis (nur zum Klicken mit der rechten Maustaste) können nur in Makros und nicht in Ereignisprozeduren abgebrochen werden. Daher müssen Sie die CancelEvent-Aktion in einem Makro verwenden, um diese Ereignisse abzubrechen.

Hinweis

Verwenden Sie die CancelEvent-Methode mit dem MouseDown-Ereignis nur, um das Ereignis abzubrechen, das auftritt, wenn Sie mit der rechten Maustaste auf ein Objekt klicken.

Bei Ereignissen, die abgebrochen werden können, tritt das Standardverhalten für das Ereignis (d. h. das, was Access normalerweise tut, wenn das Ereignis eintritt) ein, nachdem die Prozedur für das Ereignis ausgeführt wurde. Auf diese Weise können Sie das Standardverhalten abbrechen. Wenn Sie beispielsweise auf ein Wort doppelklicken, auf dem sich die Einfügemarke in einem Textfeld befindet, wird das Wort normalerweise in Access markiert. Sie können dieses Standardverhalten in der Prozedur für das DblClick-Ereignis abbrechen und eine andere Aktion ausführen, z. B. das Öffnen eines Formulars, das Informationen zu den Daten im Textfeld enthält. Bei Ereignissen, die nicht abgebrochen werden können, tritt das Standardverhalten auf, bevor die Prozedur ausgeführt wird.

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.