API:FMX.ListView.TListView.OnFilter
Delphi
property OnFilter;
C++
__property OnFilter;
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
event | published | FMX.ListView.pas FMX.ListView.hpp |
FMX.ListView | TListView |
Beschreibung
Wird beim Filtern eines Suchfeldes ausgelöst.
FMX.ListView.TListView.OnFilter erbt von FMX.ListView.TListViewBase.OnFilter. Der folgende Inhalt bezieht sich auf FMX.ListView.TListViewBase.OnFilter.
Wird beim Filtern eines Suchfeldes ausgelöst.
Mit einer Ereignisbehandlungsroutine für OnFilter können Sie einen benutzerdefinierten Filter für TSearchBox festlegen.
Das Ereignis OnFilter mit dem Typ TFilterEvent hat die folgenden Parameter:
Parameter | Beschreibung |
---|---|
Sender
|
Das Objekt, dessen Ereignisbehandlungsroutine aufgerufen wird. |
AFilter
|
Der String, der unter den verschiedenen Einträgen (Parameter AValue ) gefiltert wird.
|
AValue
|
Der String des Eintrags, bei dem die Suche von AFilter ausgeführt wird.
|
Accept
|
Boolescher Parameter für die Verwendung mit einer Filterbedingung.
Mit |
Das folgende Codefragment fügt beispielsweise einen benutzerdefinierten Filter hinzu, um zu erzwingen, dass der Eintrag (AValue
) mit dem gefilterten String (AFilter
) beginnt:
procedure TForm2.ListView1Filter(Sender: TObject; const AFilter, AValue: string;
var Accept: Boolean);
begin
Accept := AValue.StartsWith(AFilter, True);
end;
void __fastcall TForm1::ListView1Filter(TObject *Sender, const UnicodeString AFilter,
const UnicodeString AValue, bool &Accept)
{
Accept = StartsStr(AFilter.LowerCase(), AValue.LowerCase());
}
Hinweis: Aktivieren Sie die Eigenschaft SearchVisible, damit das Suchfeld über der Listenansicht angezeigt wird.