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 le message LVM_GETISEARCHSTRING explicitement.

Syntaxe

void ListView_GetISearchString(
   hwndLV,
   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 surNULL.

Valeur de retour

None

Remarques

La chaîne de recherche incrémentielle est la séquence de caractères que l’utilisateur tape alors 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, si nécessaire, le fait défiler dans l’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édiate s’en résultera.

Configuration requise

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