Structure LVFINDINFOA (commctrl.h)

Contient des informations utilisées lors de la recherche d’un élément d’affichage de liste. Cette structure est identique à LV_FINDINFO mais a été renommée pour s’adapter aux conventions d’affectation de noms standard.

Syntaxe

typedef struct tagLVFINDINFOA {
  UINT   flags;
  LPCSTR psz;
  LPARAM lParam;
  POINT  pt;
  UINT   vkDirection;
} LVFINDINFOA, *LPFINDINFOA;

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 par 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	Poursuit la recherche au début si aucune correspondance n’est trouvée. Si cet indicateur est utilisé par lui-même, 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 la direction spécifiée par le membre vkDirection . Cet indicateur est pris en charge uniquement par les modes d’icône volumineux et de 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. Il n’est valide que si LVFI_STRING ou LVFI_PARTIAL est défini dans les indicateurs de membre.

lParam

Type : LPARAM

Valeur à comparer avec le membre lParam d’une structure LVITEM d’un élément de liste. Il n’est valide que si LVFI_PARAM est défini dans les indicateurs de membre.

pt

Type : POINT

structure point avec la position de recherche initiale. Il n’est valide que si LVFI_NEARESTXY est défini dans les indicateurs membre.

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 est valide uniquement si LVFI_NEARESTXY est défini dans les indicateurs membre.

Remarques

Note

L’en-tête commctrl.h définit LVFINDINFO comme 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
d’en-tête	commctrl.h