Beschreibung:
Erstellt einen Filter auf Basis des übergebenen Filter-Ausdruckes. Die Methode entspricht technisch Filtern > Allgemein. Übergeben Sie einen leeren String (""), so wird ein bestehender Filter aufgehoben.
Der Filter kann immer nur für die jeweilige Ansicht/RecordSet ausgeführt werden. Für einen relationalen Filterausdruck können Sie entweder einen abgespeicherten Filter (SetFilterByName) oder SetFilterDirectSQL verwenden.
Wichtig: Das RecordSet-Objekt muss auf einem View basieren! Es sollten zuvor alle etwaig geholten Record- Objekte auf Nothing gesetzt werden, keinesfalls dürfen sie anschließend noch verwendet werden.
Parameter:
|
Parametername |
Typ |
Beschreibung |
|
FilterContents |
String |
Das Suchkriterium. |
|
bUseCurrentQuery |
Bool |
Optional. True: Der Filter basiert auf dem aktuell bestehenden Filter. False (Voreinstellung): Es wird ein neuer Filter erstellt. |
Rückgabewert:
Bool
|
Wert |
Beschreibung |
|
True |
Filter konnte erstellt werden. Alle gefilterten Datensätze sind ab diesem Zeitpunkt im verwendeten RecordSet-Objekt enthalten, der Filter muss aber nicht zwingend Datensätze enthalten. |
|
False |
Filter konnte nicht ausgeführt werden. Prüfen Sie ggf. Debwin auf Fehlerausgaben des Datenbanksystems. |