API:FMX.ListView.TListView.OnFilter
Delphi
property OnFilter: TFilterEvent read FOnFilter write SetOnFilter;
C++
__property OnFilter;
Properties
Type | Visibility | Source | Unit | Parent |
---|---|---|---|---|
event | published | FMX.ListView.pas FMX.ListView.hpp |
FMX.ListView | TListView |
Description
Occurs when a search box filters.
FMX.ListView.TListView.OnFilter inherits from FMX.ListView.TListViewBase.OnFilter. All content below this line refers to FMX.ListView.TListViewBase.OnFilter.
Occurs when a search box filters.
Write an event handler for OnFilter to set a custom search filter for TSearchBox.
The OnFilter event with the TFilterEvent type has the following parameters:
Parameter | Description |
---|---|
Sender
|
The object whose event handler is called. |
AFilter
|
The string being filtered among the different items (AValue parameter).
|
AValue
|
The string of the item where the search of AFilter is being performed.
|
Accept
|
Boolean parameter to use when there is a filter condition.
Use |
For example, the below code snippet adds a custom filter to force the item (AValue
) to start with the string being filtered (AFilter
):
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());
}
Note: Enable the SearchVisible property to show the search box on top of your list view.