SetFilter-Makroaktion

Gilt für: Access 2013, Office 2013

Mit der FestlegenFilter-Aktion wenden Sie auf die Datensätze im aktiven Datenblatt, Formular, Bericht oder in der aktuellen Tabelle einen Filter an.

Einstellung

Die FestlegenFilter-Aktion kann mit den folgenden Argumenten verwendet werden.

Aktionsargument	Beschreibung
Filtername	Der Name einer Abfrage oder eines Filters, der als Abfrage gespeichert wurde (sofern angegeben). In Clientdatenbanken ist dieses Argument oder das Argument WhereCondition erforderlich. In einer Webdatenbank ist dieses Argument nicht verfügbar.
Bedingung	Eine SQL WHERE-Klausel, die die Datensätze im Datenblatt, im Formular, im Bericht oder in der Tabelle einschränkt (sofern angegeben). In einer Webdatenbank ist dieses Argument erforderlich.
Steuerelementname	Der Name des Steuerelements, das dem zu filternden Unterformular oder Unterbericht entspricht (sofern angegeben). Ohne Angabe wird das aktuelle Objekt gefiltert.

Hinweise

In einer Webdatenbank darf das Argument Where Condition nicht mit einem Gleichheitszeichen (=) beginnen.

Beim Ausführen dieser Aktion wird der Filter auf die Tabelle, das Formular, den Bericht oder das Datenblatt (z. B. Abfrageergebnis) angewendet, das aktiv ist und den Fokus besitzt.

Mit der Filter -Eigenschaft des aktiven Objekts können Sie das WhereCondition-Argument speichern und zu einem späteren Zeitpunkt anwenden. Filter werden zusammen mit den Objekten gespeichert, in denen sie erstellt wurden. Sie werden zwar automatisch geladen, wenn das Objekt geöffnet wird, aber werden nicht automatisch angewendet.

Um in einer Clientdatenbank automatisch einen Filter anzuwenden, wenn das Objekt geöffnet wird, legen Sie die FilterOnLoad-Eigenschaft auf True fest.

Wenn Sie in einer Webdatenbank beim Öffnen eines Objekts automatisch einen Filter anwenden möchten, fügen Sie einem Makro die FestlegenFilter-Aktion hinzu, und fügen Sie das Makro dem BeiLaden-Ereignis des Objekts hinzu.

Beispiel

Das folgende Beispiel zeigt die Verwendung der Aktion SetFilter zum Filtern des Formulars, in dem das Makro definiert wurde.

Der Beispielcode stammt von:Microsoft Access 2010 Programmer's Reference.

    OpenForm
        Form Name sfrmFoods
        View Form
        Filter Name
        Where Condition
        Data Mode
        Window Mode Normal
    
    SetFilter
        Filter Name
        Where Condition =[display_name] Like "*cheese*"
        Control Name