Share via


CB_FINDSTRING message

Recherche dans la zone de liste d’une zone de liste modifiable un élément commençant par les caractères d’une chaîne spécifiée.

Paramètres

wParam

Index de base zéro de l’élément précédant le premier élément à rechercher. Lorsque la recherche atteint le bas de la zone de liste, elle passe du haut de la zone de liste à l’élément spécifié par le paramètre wParam . Si wParam a la valeur -1, la zone de liste entière est recherchée à partir du début.

lParam

Pointeur vers la chaîne terminée par null qui contient les caractères pour lesquels rechercher. La recherche ne respecte pas la casse. Cette chaîne peut donc contenir n’importe quelle combinaison de lettres majuscules et minuscules.

Valeur retournée

La valeur de retour est l’index de base zéro de l’élément correspondant. Si la recherche échoue, elle est CB_ERR.

Notes

Si vous créez la zone de liste déroulante avec un style dessiné par le propriétaire, mais sans le style CBS_HASSTRINGS, le CB_FINDSTRING message dépend de l’utilisation ou non du style CBS_SORT par votre application. Si vous utilisez le style CBS_SORT , WM_COMPAREITEM messages sont envoyés au propriétaire de la zone de liste déroulante pour déterminer l’élément correspondant à la chaîne spécifiée. Si vous n’utilisez pas le style CBS_SORT , le message CB_FINDSTRING recherche un élément de liste qui correspond à la valeur du paramètre lParam .

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
Winuser.h (inclure Windows.h)

Voir aussi

Référence

CB_FINDSTRINGEXACT

CB_SELECTSTRING

CB_SETCURSEL

WM_COMPAREITEM