Structure LVFINDINFOW (commctrl.h)

Article
03/14/2023

Contient les informations utilisées lors de la recherche d’un élément list-view. Cette structure est identique à LV_FINDINFO, mais a été renommée pour s’adapter aux conventions de nommage standard.

Syntaxe

typedef struct tagLVFINDINFOW {
  UINT    flags;
  LPCWSTR psz;
  LPARAM  lParam;
  POINT   pt;
  UINT    vkDirection;
} LVFINDINFOW, *LPFINDINFOW;

Membres

flags

Type : UINT

Type de recherche à effectuer. Ce membre peut être défini sur une ou plusieurs des valeurs suivantes :

Valeur	Signification
LVFI_PARAM	Recherche une correspondance entre le membre lParam de cette structure et le membre lParam de la structure LVITEM d’un élément.
LVFI_PARTIAL	Vérifie si le texte de l’élément commence par la chaîne pointée vers le membre psz . Cette valeur implique l’utilisation de LVFI_STRING.
LVFI_STRING	Recherche en fonction du texte de l’élément. Sauf si des valeurs supplémentaires sont spécifiées, le texte de l’élément correspondant doit correspondre exactement à la chaîne pointée par le membre psz . Toutefois, la recherche ne respecte pas la casse.
LVFI_SUBSTRING	Windows Vista et versions ultérieures. Équivalent à LVFI_PARTIAL.
LVFI_WRAP	Continue la recherche au début si aucune correspondance n’est trouvée. Si cet indicateur est utilisé seul, il est supposé qu’une recherche de chaîne est souhaitée.
LVFI_NEARESTXY	Recherche l’élément le plus proche de la position spécifiée dans le membre pt , dans le sens spécifié par le membre vkDirection . Cet indicateur est pris en charge uniquement par les modes icône grande et petite icône. Si LVFI_NEARESTXY est spécifié, tous les autres indicateurs sont ignorés.

psz

Type : LPCTSTR

Adresse d’une chaîne terminée par null à comparer avec le texte de l’élément. Elle n’est valide que si LVFI_STRING ou LVFI_PARTIAL est défini dans le membre indicateurs .

lParam

Type : LPARAM

Valeur à comparer avec le membre lParam de la structure LVITEM d’un élément de liste. Elle est valide uniquement si LVFI_PARAM est défini dans le membre indicateurs .

pt

Type : POINT

Structure POINT avec la position de recherche initiale. Elle est valide uniquement si LVFI_NEARESTXY est défini dans le membre indicateurs .

vkDirection

Type : UINT

Code de clé virtuelle qui spécifie le sens de la recherche. Les codes suivants sont pris en charge :

VK_LEFT
VK_RIGHT
VK_UP
VK_DOWN
VK_HOME
VK_END
VK_PRIOR
VK_NEXT

Ce membre n’est valide que si LVFI_NEARESTXY est défini dans le membre indicateurs .

Notes

L’en-tête commctrl.h définit LVFINDINFO comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	commctrl.h

Partager via