Report.ApplyFilter-Ereignis (Access)

  • Artikel

Tritt auf, wenn ein Filter auf einen Bericht angewendet wird.

Syntax

Ausdruck. 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.

HinwBemerkungeneise

Um ein Makro oder eine Ereignisprozedur auszuführen, 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 richtig ist. Sie können beispielsweise sicherstellen, dass jeder Filter, der auf einen Auftragsbericht angewendet wird, Kriterien enthält, die das Feld OrderDate einschränken. Überprüfen Sie dazu den Wert der Filter - oder ServerFilter-Eigenschaft des Berichts, um sicherzustellen, dass dieses Kriterium im WHERE-Klauselausdruck 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 Filter-Ereignisses ausgeführt haben. Sie können beispielsweise einige Steuerelemente im Bericht deaktivieren oder ausblenden, wenn der Benutzer den Filter erstellt, da diese Steuerelemente nicht in die Filterkriterien eingeschlossen 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 nachdem das Fenster Erweiterter Filter/Sortierung geschlossen wurde, 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 an oder entfernt einen Filter mithilfe der Aktionen ApplyFilter, OpenReport oder ShowAllRecords in einem Makro oder der entsprechenden Methoden des DoCmd-Objekts in Visual Basic.

  • Verwendet die Schließen-Aktion oder die Close-Methode des DoCmd-Objekts , um das Fenster Erweiterte Filter/Sortierung zu schließen.

  • Legt die Filter - oder ServerFilter-Eigenschaft oder die FilterOn-Eigenschaft in einem Makro oder Visual Basic fest (obwohl Sie diese Eigenschaften in einer ApplyFilter-Ereignisprozedur oder einem Makro festlegen können).

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.