Report.Filter-Ereignis (Access)

Tritt auf, wenn der Benutzer ein Filterfenster öffnet, indem er Erweiterte Filter/Sortierung auswählt.

Syntax

Ausdruck. Filter (Cancel, FilterType)

Ausdruck Eine Variable, die ein Report-Objekt darstellt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
Abbrechen Erforderlich Integer Diese Einstellung bestimmt, ob das Filterdefinitionsfenster geöffnet wird. Durch Festlegen des Cancel-Arguments auf True (1) wird verhindert, dass das Filterfenster geöffnet wird. Sie können das Öffnen des Filterdefinitionsfensters auch mit der CancelEvent -Methode des DoCmd -Objekts unterbinden.
FilterType Erforderlich Integer Das Filterdefinitionsfenster, das der Benutzer zu öffnen versucht. Das Argument FilterType kann acFilterAdvanced sein.

HinwBemerkungeneise

Wenn beim Auftreten dieses Ereignisses ein Makro oder eine Ereignisprozedur ausgeführt werden soll, legen Sie die OnFilter-Eigenschaft auf den Namen des Makros oder auf [Ereignisprozedur] fest.

Verwenden Sie das Filter-Ereignis für Folgendes:

  • Entfernen Sie alle vorherigen Filter für den Bericht. Legen Sie dazu die Filter-Eigenschaft oder die ServerFilter-Eigenschaft des Berichts in der Filter-Makro - oder Ereignisprozedur auf eine leere Zeichenfolge (" ") fest. Dies ist besonders nützlich, wenn Sie sicherstellen möchten, dass im neuen Filter keine überflüssigen Kriterien angezeigt werden. Wenn Sie beispielsweise das Feature Nach Auswahl filtern verwenden, werden die verwendeten Kriterien (der ausgewählte Text im Bericht) dem WHERE-Klauselausdruck der Filter - oder ServerFilter-Eigenschaft hinzugefügt und im Fenster Erweiterter Filter/Sortierung angezeigt. You can remove these old criteria by using the Filter event.

  • Geben Sie die Standardeinstellungen für den neuen Filter ein. Legen Sie dazu die Filter-Eigenschaft oder die ServerFilter-Eigenschaft fest, um diese Kriterien einzuschließen. Beispielsweise können Sie möchten, dass alle Filter für einen Produktbericht nur aktuelle Produkte anzeigen (Produkte, für die das Steuerelement Nicht mehr im Bericht Produkte ausgewählt ist).

  • Verwenden Sie Ihr eigenes benutzerdefiniertes Filterfenster anstelle eines der Microsoft Access-Filterfenster. Wenn das Filter-Ereignis auftritt, können Sie Ihr eigenes benutzerdefiniertes Formular öffnen und die Einträge in diesem Bericht verwenden, um die Filter-Eigenschaft oder die ServerFilter-Eigenschaft festzulegen und den ursprünglichen Bericht zu filtern. Wenn der Benutzer dieses benutzerdefinierte Formular schließt, legen Sie die FilterOn-Eigenschaft oder die ServerFilterByForm-Eigenschaft des ursprünglichen Berichts auf True (1) fest, um den Filter anzuwenden. Durch das Abbrechen des Filter-Ereignisses wird verhindert, dass das Access-Filterfenster geöffnet 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.