Vcl.ComCtrls.TCustomListView.OwnerDataFind

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function OwnerDataFind(Find: TItemFind; const FindString: string;  const FindPosition: TPoint; FindData: TCustomData; StartIndex: Integer; Direction: TSearchDirection; Wrap: Boolean): Integer; virtual;

C++

virtual int __fastcall OwnerDataFind(TItemFind Find, const System::UnicodeString FindString, const System::Types::TPoint &FindPosition, void * FindData, int StartIndex, TSearchDirection Direction, bool Wrap);

Propriétés

Type Visibilité  Source Unité  Parent
function protected
Vcl.ComCtrls.pas
Vcl.ComCtrls.hpp
Vcl.ComCtrls TCustomListView

Description

Recherche un élément dans le contrôle vue liste.

Redéfinissez OwnerDataFind dans une classe dérivée pour implémenter la fonction de recherche dans un contrôle vue liste virtuelle (c'est-à-dire si OwnerData a la valeur true).

OwnerDataFind est appelée quand la vue liste virtuelle doit trouver un élément ; ainsi, OwnerDataFind est appelée quand un utilisateur emploie la recherche incrémentielle.

Find précise le type de recherche à effectuer (ifData, ifPartialString, ifExactString ou ifNearest).

FindString précise le texte de l'élément cherché. FindString est ignoré sauf si Find contient ifPartialString ou ifExactString.

FindPosition précise le point de départ de la recherche. FindPosition n'est pris en compte que si Find contient ifNearest.

FindData précise les données de l'élément cherché. FindData est ignoré sauf si Find contient ifData.

StartIndex précise l'index de l'élément à partir duquel la recherche doit commencer.

Direction précise le sens de la recherche (sdLeft, sdRight, sdAbove, sdBelow ou sdAll).

Wrap précise si la recherche doit continuer vers le début du contrôle d'affichage de liste si aucune correspondance n'est trouvée.

OwnerDataFind doit renvoyer l'indice de l'élément trouvé. Si aucun élément n'est trouvé, OwnerDataFind renvoie -1.

Voir aussi