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.
Tritt auf, wenn ein Filter auf einen Bericht angewendet wird.
Syntax
Ausdruck verwendet werden. ApplyFilter (Cancel, ApplyType)
Ausdruck Eine Variable, die ein Report-Objekt darstellt.
Parameter
| Name | Erforderlich/Optional | Datentyp | Beschreibung |
|---|---|---|---|
| Abbrechen | Erforderlich | Integer | Durch die Einstellung wird bestimmt, ob das ApplyFilter-Ereignis auftritt. Wenn Sie das Argument Cancel auf True festlegen, wird das ApplyFilter-Ereignis abgebrochen, und der Filter wird nicht auf den Bericht angewendet. |
| ApplyType | Erforderlich | Integer | Gibt den Typ des angewendeten Filters zurück. |
Hinweise
Wenn Sie ein Makro oder eine Ereignisprozedur ausführen möchten, wenn dieses Ereignis auftritt, legen Sie die OnApplyFilter-Eigenschaft auf den Namen des Makros oder auf [Ereignisprozedur] fest.
Verwenden Sie das ApplyFilter-Ereignis für Folgendes:
Stellen Sie sicher, dass der angewendete Filter korrekt ist. Sie können beispielsweise sicherstellen, dass jeder Filter, der auf einen Bestellbericht angewendet wird, Kriterien enthält, die das Feld "Bestelldatum " einschränken. Überprüfen Sie dazu den Eigenschaftswert "Filter " oder " ServerFilter" des Berichts, um sicherzustellen, dass dieses Kriterium im Ausdruck der WHERE-Klausel enthalten ist.
Ändern der Darstellungsweise des Berichts, bevor ein Filter angewendet wird. Dies bietet sich z. B. an, wenn Sie einige Felder deaktivieren oder ausblenden möchten, die für die von diesem Filter angezeigten Datensätze überflüssig sind.
Rückgängigmachen oder Ändern von Aktionen, die Sie beim Auftreten des Filterereignisses ausgeführt haben. Sie können z. B. einige Steuerelemente im Bericht deaktivieren oder ausblenden, wenn der Benutzer den Filter erstellt, da diese Steuerelemente nicht in die Filterkriterien einbezogen werden sollen. Sie können diese Steuerelemente wieder aktivieren oder anzeigen, nachdem der Filter angewendet wurde.
Die Aktionen in der ApplyFilter-Ereignisprozedur oder dem Makro treten auf, bevor der Filter angewendet oder entfernt wird, oder nach dem Schließen des Fensters "Erweiterter Filter/Sortieren", aber bevor der Bericht erneut angezeigt wird. Die Kriterien, die Sie in den neu erstellten Filter eingegeben haben, stehen der ApplyFilter-Ereignisprozedur oder dem Makro als Einstellung der Filter - oder ServerFilter-Eigenschaft zur Verfügung.
Das ApplyFilter-Ereignis tritt nicht auf, wenn der Benutzer einen der folgenden Schritte ausführt:
Wendet einen Filter mithilfe der Aktionen ApplyFilter, OpenReport oder ShowAllRecords in einem Makro oder der entsprechenden Methoden des DoCmd-Objekts in Visual Basic an oder entfernt einen Filter.
Verwendet die Aktion Schließen oder die Methode Schließen des DoCmd-Objekts , um das Fenster Erweiterter Filter/Sortierung zu schließen.
Legt die Filter - oder ServerFilter-Eigenschaft oder die FilterOn-Eigenschaft in einem Makro oder Visual Basic fest (Sie können diese Eigenschaften aber auch in einer ApplyFilter-Ereignisprozedur oder einem ApplyFilter-Makro festlegen).
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.