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 |