CB_SELECTSTRING message

Recherche dans la liste d’une zone de liste modifiable un élément qui commence par les caractères d’une chaîne spécifiée. Si un élément correspondant est trouvé, il est sélectionné et copié dans le contrôle d’édition.

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 liste, elle passe du haut de la liste à l’élément spécifié par le paramètre wParam . Si wParam a la valeur -1, la 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

Si la chaîne est trouvée, la valeur de retour est l’index de l’élément sélectionné. Si la recherche échoue, la valeur de retour est CB_ERR et la sélection actuelle n’est pas modifiée.

Notes

Une chaîne est sélectionnée uniquement si les caractères du point de départ correspondent aux caractères de la chaîne de préfixe.

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_SELECTSTRING message dépend de l’utilisation ou non du style CBS_SORT. Si le style CBS_SORT est utilisé, le système envoie WM_COMPAREITEM messages 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 , CB_SELECTSTRING tente de faire correspondre la valeur DWORD à 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_FINDSTRING

CB_FINDSTRINGEXACT

CB_SETCURSEL

WM_COMPAREITEM