FMX.ListView.TListViewBase.OnFilter

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property OnFilter: TFilterEvent read FOnFilter write SetOnFilter;

C++

__property Fmx::Searchbox::TFilterEvent OnFilter = {read=FOnFilter, write=SetOnFilter};

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
event public
FMX.ListView.pas
FMX.ListView.hpp
FMX.ListView TListViewBase


Beschreibung

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