API:FMX.ListView.TListView.OnFilter
Delphi
property OnFilter: TFilterEvent read FOnFilter write SetOnFilter;
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. {{#multireplace:FMX.ListView.TListView.OnFilter|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} erbt von {{#multireplace:FMX.ListView.TListViewBase.OnFilter|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}}. Der folgende Inhalt bezieht sich auf {{#multireplace:FMX.ListView.TListViewBase.OnFilter|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}}.
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.