API:FMX.ListView.TListView.OnFilter
Delphi
property OnFilter: TFilterEvent read FOnFilter write SetOnFilter;
C++
__property OnFilter;
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| event | published | FMX.ListView.pas FMX.ListView.hpp |
FMX.ListView | TListView |
説明
検索ボックスのフィルタリング時に発生します。 {{#multireplace:FMX.ListView.TListView.OnFilter|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} は {{#multireplace:FMX.ListView.TListViewBase.OnFilter|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} を継承しています。以下の内容はすべて {{#multireplace:FMX.ListView.TListViewBase.OnFilter|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} を参照しています。
検索ボックスのフィルタリング時に発生します。
OnFilter のイベント ハンドラを記述すると、TSearchBox のカスタム検索フィルタを設定できます。
TFilterEvent 型の OnFilter イベントには次のパラメータがあります。
| パラメータ | 説明 |
|---|---|
Sender
|
呼び出されるイベント ハンドラの所属先のオブジェクトです。 |
AFilter
|
さまざまな項目（AValue パラメータ）の中からフィルタリングされる文字列です。
|
AValue
|
AFilter の検索が実行される項目の文字列です。
|
Accept
|
フィルタ条件が存在する場合に使用する論理型パラメータです。
フィルタ条件を追加するために |
たとえば、以下のサンプル コードでは、項目（AValue）がフィルタリング文字列（AFilter）で始まるかどうかを判定するカスタム フィルタを追加しています。
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());
}
メモ： SearchVisible プロパティを有効にすると、リスト ビューの上部に検索ボックスが表示されます。