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 |
|