GebeurtenisAnnuleren, macroactie

Instelling

De actie GebeurtenisAnnuleren heeft geen argumenten.

Opmerkingen

Op een formulier gebruikt u de actie GebeurtenisAnnuleren meestal in een validatiemacro, samen met de gebeurteniseigenschap BeforeUpdate. Als een gebruiker gegevens invoert in een besturingselement of record, wordt de macro uitgevoerd voordat de gegevens aan de database worden toegevoegd. Als de gegevens niet voldoen aan de voorwaarden voor gegevensvalidatie in de macro, zorgt de actie GebeurtenisAnnuleren ervoor dat het bijwerkenproces niet wordt gestart.

Deze actie wordt vaak gebruikt in combinatie met de actie Berichtvak om aan te geven dat de gegevens niet voldoen aan de voorwaarden voor validatie en om nuttige informatie te verstrekken aan de gebruiker over het type gegevens dat moet worden ingevoerd.

De volgende gebeurtenissen kunnen worden geannuleerd met de actie GebeurtenisAnnuleren.

Als in de gebeurteniseigenschap OnDblClick van een besturingselement een macro is opgegeven die de actie GebeurtenisAnnuleren bevat, heeft de actie tot gevolg dat de gebeurtenis DblClick wordt geannuleerd.

Voor gebeurtenissen die kunnen worden geannuleerd, is het standaardgedrag voor de gebeurtenis (dus wat er meestal gebeurt in Access als de gebeurtenis plaatsvindt) van toepassing nadat de macro voor de gebeurtenis is uitgevoerd. Op deze manier kunt u het standaardgedrag annuleren. Als u bijvoorbeeld in een tekstvak dubbelklikt op een woord waarin zich de invoegpositie bevindt, is de standaardinstelling dat het woord wordt geselecteerd. U kunt dit standaardgedrag in de macro annuleren voor de gebeurtenis DblClick en een andere actie uitvoeren, zoals het openen van een formulier met informatie over de gegevens in het tekstvak. Voor gebeurtenissen die niet kunnen worden geannuleerd, vindt het standaardgedrag plaats voordat de macro wordt uitgevoerd.

Als u de actie GebeurtenisAnnuleren wilt uitvoeren in een VBA-module (Visual Basic for Applications), gebruikt u de methode GebeurtenisAnnuleren van het object DoCmd.

Voorbeeld

Gegevens valideren met behulp van een macro

Met de volgende validatiemacro worden de postcodes gecontroleerd die worden ingevoerd in een formulier Leveranciers. In het voorbeeld ziet u hoe u de acties MacroStoppen, Berichtvak, GebeurtenisAnnuleren en NaarBesturingselementGaan kunt gebruiken. Een voorwaardelijke expressie controleert de waarden die in een record in het formulier worden ingevoerd voor land/regio en postcode. Als de postcode niet de juiste notatie heeft voor het land of de regio, wordt via de macro een berichtvenster weergegeven en wordt de record niet opgeslagen. De gebruiker gaat terug naar het besturingselement Postcode, waar de fout kan worden gecorrigeerd. Deze macro moet worden gekoppeld aan de eigenschap BeforeUpdate van het formulier Leveranciers.