LVM_GETISEARCHSTRING message

Récupère la chaîne de recherche incrémentielle d’un contrôle list-view. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro ListView_GetISearchString .

Paramètres

wParam

Doit être zéro.

lParam

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 lParam sur NULL.

Valeur retournée

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

Notes

Avertissement de sécurité : L’utilisation incorrecte de ce message peut compromettre la sécurité de votre programme. Ce message ne vous permet pas de connaître la taille de la mémoire tampon. Si vous utilisez ce message, appelez d’abord le message qui passe la valeur NULL dans l’objet lParam, cela retourne le nombre de caractères, à l’exception de null requis. Appelez ensuite le message une deuxième fois pour récupérer la chaîne. Vous devez passer en revue les considérations relatives à la sécurité : Contrôles Microsoft Windows avant de continuer.

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 et le caractère NULL de fin. S’il est trop petit, une erreur de page non valide immédiate s’en résultera.

Spécifications

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]
En-tête	Commctrl.h
Noms Unicode et ANSI	LVM_GETISEARCHSTRINGW (Unicode) et LVM_GETISEARCHSTRINGA (ANSI)