Partager via


LB_SELECTSTRING message

Recherche dans une zone de liste un élément qui commence par les caractères d’une chaîne spécifiée. Si un élément correspondant est trouvé, l’élément est sélectionné.

Paramètres

wParam

Index de base zéro de l'élément précédant le premier élément sur lequel la recherche est effectuée. Lorsque la recherche atteint le bas de la zone de liste, elle continue à partir du haut de la zone de liste jusqu’à l’élément spécifié par le paramètre wParam . Si wParam a la valeur -1, la totalité de la zone de liste est recherchée depuis le début.

Windows 95/Windows 98/Windows Millennium Edition (Windows Me) : le paramètre wParam est limité aux valeurs 16 bits. Cela signifie que les zones de liste ne peuvent pas contenir plus de 32 767 éléments. Bien que le nombre d’éléments soit limité, la taille totale en octets des éléments d’une zone de liste est limitée uniquement par la mémoire disponible.

lParam

Pointeur vers la chaîne terminée par null qui contient le préfixe pour lequel effectuer la recherche. La recherche étant indépendante de la casse, cette chaîne peut contenir n’importe quelle combinaison de lettres majuscules et minuscules.

Valeur retournée

Si la recherche réussit, la valeur de retour est l’index de l’élément sélectionné. Si la recherche échoue, la valeur de retour est LB_ERR et la sélection actuelle n’est pas modifiée.

Notes

La zone de liste défile, si nécessaire, pour afficher l’élément sélectionné.

N’utilisez pas ce message avec une zone de liste qui a les styles LBS_MULTIPLESEL ou LBS_EXTENDEDSEL .

Un élément est sélectionné uniquement si ses caractères initiaux du point de départ correspondent aux caractères de la chaîne spécifiée par le paramètre lParam .

Si la zone de liste a le style dessiné par le propriétaire, mais pas le style LBS_HASSTRINGS , l’action effectuée par LB_SELECTSTRING dépend de l’utilisation ou non du style LBS_SORT . Si LBS_SORT est utilisé, le système envoie WM_COMPAREITEM messages au propriétaire de la zone de liste pour déterminer l’élément qui correspond à la chaîne spécifiée. Sinon, LB_SELECTSTRING tente de trouver un élément qui a une valeur longue (fournie en tant que paramètre lParam du message LB_ADDSTRING ou LB_INSERTSTRING ) qui correspond au 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

LB_ADDSTRING

LB_FINDSTRING

LB_INSERTSTRING