FMX.ListView.TListView.OnFilter

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property OnFilter: TFilterEvent read FOnFilter write SetOnFilter;

C++

__property OnFilter;

Propriétés

Type Visibilité  Source Unité  Parent
event published
FMX.ListView.pas
FMX.ListView.hpp
FMX.ListView TListView

Description

Se produit lorsqu'une zone de recherche effectue un filtrage.

FMX.ListView.TListView.OnFilter hérite de FMX.ListView.TListViewBase.OnFilter. Tout le contenu en-dessous de cette ligne se réfère à FMX.ListView.TListViewBase.OnFilter.

Se produit lorsqu'une zone de recherche effectue un filtrage.

Ecrivez un gestionnaire d'événement pour OnFilter afin de définir un filtre de recherche personnalisé pour TSearchBox.

L'événement OnFilter ayant le type TFilterEvent comporte les paramètres suivants :

Paramètre Description
Sender L'objet dont le gestionnaire d'événement est appelé.
AFilter La chaîne en train d'être filtrée parmi les différents éléments (paramètre AValue).
AValue La chaîne de l'élément dans lequel la recherche de AFilter est en cours d'exécution.
Accept Paramètre booléen à utiliser quand il y a une condition de filtre.

Utilisez Accept pour ajouter une condition de filtre ; si une valeur est filtrée par la condition de filtre, Accept doit avoir la valeur True.


Par exemple, l'extrait de code ci-dessous ajoute un filtre personnalisé pour forcer l'élément (AValue) à commencer par la chaîne en train d'être filtrée (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());
}

Remarque : Activez la propriété SearchVisible pour afficher la zone de recherche en haut de votre vue liste.

Voir aussi