macro ListView_GetISearchString (commctrl.h)

Obtient la chaîne de recherche incrémentielle d’un contrôle list-view. Vous pouvez utiliser cette macro ou envoyer explicitement le message LVM_GETISEARCHSTRING.

Syntaxe

BOOL ListView_GetISearchString(
   HWND  hwndLV,
   LPSTR lpsz
);

Paramètres

hwndLV

Type : HWND

Handle du contrôle list-view.

lpsz

Type : LPSTR

Pointeur vers une mémoire tampon qui reçoit la chaîne de recherche incrémentielle. Pour récupérer simplement la longueur de la chaîne, définissez lpsz sur NULL.

Valeur de retour

Type : BOOL

Retourne le nombre de caractères dans la chaîne de recherche incrémentielle, ou zéro si le contrôle list-view n’est pas en mode de recherche incrémentiel.

Remarques

La chaîne de recherche incrémentielle est la séquence de caractères que l’utilisateur tape pendant que l’affichage liste a le focus d’entrée. Chaque fois que l’utilisateur tape un caractère, le système ajoute le caractère à la chaîne de recherche, puis recherche un élément correspondant. Si le système trouve une correspondance, il sélectionne l’élément et, le cas échéant, le fait défiler en mode affichage.

Un délai d’attente est associé à chaque caractère que l’utilisateur tape. Si le délai d’attente s’écoule avant que l’utilisateur tape un autre caractère, la chaîne de recherche incrémentielle est réinitialisée.

Assurez-vous que la mémoire tampon est suffisamment grande pour contenir la chaîne. S’il est trop petit, une erreur de page non valide immédiatement entraîne un résultat.

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]
plateforme cible	Windows
d’en-tête	commctrl.h