message LB_SETCARETINDEX

Définit le rectangle de focus sur l’élément à l’index spécifié dans une zone de liste à sélection multiple. Si l’élément n’est pas visible, il fait défiler l’affichage.

Paramètres

wParam

Spécifie l’index de base zéro de l’élément de zone de liste qui doit recevoir le rectangle de focus.

Windows 95/Windows 98/Windows Millennium Edition (Windows Me) : le paramètre wParam est limité à des 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

Si cette valeur est FALSE, l’élément est fait défiler jusqu’à ce qu’il soit entièrement visible ; s’il est VRAI, l’élément est fait défiler jusqu’à ce qu’il soit au moins partiellement visible.

Valeur retournée

Si une erreur se produit, la valeur de retour est LB_ERR (-1). Sinon, LB_OKAY (0) est retourné.

Remarques

Si ce message est envoyé à une zone de liste de sélection unique qui ne contient pas d’élément sélectionné, l’index caret est défini sur l’élément spécifié par le paramètre wParam . Si la zone de liste à sélection unique contient un élément sélectionné, la zone de liste retourne LB_ERR.

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

LB_GETCARETINDEX