LB_SETCARETINDEX message

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 est défilé dans 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é 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

Si cette valeur est FALSE, l’élément défile jusqu’à ce qu’il soit entièrement visible ; s’il a la valeur TRUE, l’élément défile 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é.

Notes

Si ce message est envoyé à une zone de liste à sélection unique qui ne contient pas d’élément sélectionné, l’index d’insertion 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 renvoie 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