_Message SELECTSTRING lb

Recherche un élément qui commence par les caractères d’une chaîne spécifiée dans une zone de liste. 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 est-1, la zone de liste entière est recherchée à partir du début.

Windows 95/Windows 98/Windows Millennium edition (Windows) : 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 n’est limitée que par la mémoire disponible.

lParam

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

Valeur de retour

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 avec les styles _ MULTIPLESEL ou lbs _ EXTENDEDSEL .

Un élément est sélectionné uniquement si ses caractères initiaux à partir 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 owner-drawn, mais pas le style _ HASSTRINGS kg , l’action entreprise par lb _ SELECTSTRING varie selon que le style de _ Tri lbs est utilisé ou non. Si le _ tri de lbs est utilisé, le système envoie des messages WM _ COMPAREITEM au propriétaire de la zone de liste pour déterminer l’élément qui correspond à la chaîne spécifiée. Dans le cas contraire, lb _ SELECTSTRING tente de trouver un élément ayant une valeur long (fourni comme 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 [Applications de bureau Vista uniquement]
Serveur minimal pris en charge
Windows Serveur 2003 [ applications de bureau uniquement]
En-tête
Winuser. h (inclure Windows. h)

Voir aussi

Référence

LB _ ADDSTRING

_FindString lb

_INSERTSTRING lb