API:FMX.ListView.TListView.OnFilter

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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 Accept fügen Sie eine Filterbedingung hinzu; wenn ein Wert mit der Filterbedingung gefiltert wird, muss Accept True sein.


Das folgende Codefragment fügt beispielsweise einen benutzerdefinierten Filter hinzu, um zu erzwingen, dass der Eintrag (AValue) mit dem gefilterten String (AFilter) beginnt:

Delphi:
procedure TForm2.ListView1Filter(Sender: TObject; const AFilter, AValue: string;
  var Accept: Boolean);
begin
  Accept :=  AValue.StartsWith(AFilter, True);
end;
C++:
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.

Siehe auch