Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Das Dirty-Ereignis tritt auf, wenn sich der Inhalt des angegebenen Steuerelements ändert.
Syntax
Ausdruck verwendet werden. Dirty (Abbrechen)
Ausdruck Eine Variable, die ein WebBrowserControl-Objekt darstellt.
Parameter
| Name | Erforderlich/Optional | Datentyp | Beschreibung |
|---|---|---|---|
| Abbrechen | Erforderlich | Integer | Diese Einstellung bestimmt, ob das Dirty-Ereignis eintritt. Wenn Sie das Cancel-Argument auf True (1) festlegen, wird das Dirty-Ereignis abgebrochen. |
Rückgabewert
Nichts
Bemerkungen
Beispiele für dieses Ereignis sind die direkte Eingabe eines Zeichens in das Text- oder Kombinationsfeld oder das Ändern der Text-Eigenschaftseinstellung des Steuerelements mithilfe eines Makros oder Visual Basic.
Das Ändern eines Datensatzes in einem Formular unter Verwendung eines Makros oder mit Visual Basic löst dieses Ereignis nicht aus. Sie müssen die Daten direkt in den Datensatz eingeben oder die Text-Eigenschaft des Steuerelements festlegen.
Dieses Ereignis betrifft nur gebundene Formulare, nicht ein ungebundenes Formular oder einen Bericht.
Um ein Makro oder eine Ereignisprozedur auszuführen, wenn dieses Ereignis auftritt, legen Sie die OnDirty-Eigenschaft auf den Namen des Makros oder auf [Ereignisprozedur] fest.
Durch Ausführen eines Makros oder einer Ereignisprozedur beim Auftreten eines Dirty-Ereignisses können Sie feststellen, ob der Datensatz geändert werden kann. Außerdem können Sie eine Meldung anzeigen und nach der Berechtigung zum Bearbeiten fragen.
Das Ändern der Daten in einem Datensatz mithilfe der Tastatur bewirkt, dass zusätzlich zu Steuerereignissen wie dem Dirty-Ereignis Tastaturereignisse auftreten. For example, if you move to a new record and type an ANSI character in a text box in the record, the following events occur in this order:
KeyDown → KeyPress → BeforeInsert → Dirty → KeyUp
Die Ereignisse BeforeUpdate und AfterUpdate für einen Datensatz treten auf, nachdem Sie die neuen oder geänderten Daten in den Datensatz eingegeben und zu einem anderen Datensatz verschoben haben (oder im Menü Datensätzedie Option Datensatz speichern auswählen) und damit nach dem Dirty-Ereignis für den Datensatz.
Das Abbrechen des Dirty-Ereignisses führt dazu, dass die Änderungen am aktuellen Datensatz zurückgesetzt werden. Das entspricht dem Drücken der Esc-Taste.
Beispiel
Im folgenden Beispiel wird die Schaltfläche btnUndo aktiviert , wenn Daten geändert werden. Das Unterprogramm UndoEdits( ) wird vom Dirty-Ereignis der Textfeldsteuerelemente aufgerufen. Durch Klicken auf die aktivierte Schaltfläche btnUndo wird der ursprüngliche Wert des Steuerelements mithilfe der OldValue-Eigenschaft wiederhergestellt.
Private Sub Form_Dirty()
If Me.Dirty Then
Me!btnUndo.Enabled = True ' Enable button.
Else
Me!btnUndo.Enabled = False ' Disable button.
End If
End Sub
Sub btnUndo_Click()
Dim ctlC As Control
' For each control.
For Each ctlC in Me.Controls
If ctlC.ControlType = acTextBox Then
' Restore Old Value.
ctlC.Value = ctlC.OldValue
End If
Next ctlC
End Sub
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.