FMX.SearchBox.TSearchBoxModel.OnFilter

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property OnFilter: TFilterEvent read FOnFilter write FOnFilter;

C++

__property TFilterEvent OnFilter = {read=FOnFilter, write=FOnFilter};

Propriétés

Type Visibilité  Source Unité  Parent
event public
FMX.SearchBox.pas
FMX.SearchBox.hpp
FMX.SearchBox TSearchBoxModel


Description

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 TForm1.SearchBox1Filter(Sender: TObject; const AFilter,  AValue: string; var Accept: Boolean);
begin
  Accept :=  AValue.StartsWith(AFilter, True);
end;
C++ :
void __fastcall TForm1::SearchBox1Filter(TObject *Sender, const UnicodeString AFilter,  const UnicodeString AValue, bool &Accept)
{
	Accept = StartsStr(AFilter.LowerCase(), AValue.LowerCase());
}

Voir aussi