Partager via


SBM_SETPOS message

Le message SBM_SETPOS est envoyé pour définir la position de la zone de défilement (pouce) et, si nécessaire, redessiner la barre de défilement pour refléter la nouvelle position de la zone de défilement.

Les applications ne doivent pas envoyer ce message directement. Au lieu de cela, ils doivent utiliser la fonction SetScrollPos . Une fenêtre reçoit ce message via sa fonction WindowProc. Les applications qui implémentent un contrôle de barre de défilement personnalisé doivent répondre à ces messages pour que la fonction SetScrollPos fonctionne correctement.

Paramètres

wParam

Spécifie la nouvelle position de la zone de défilement. Il doit se trouver dans la plage de défilement. Si ce paramètre est en dehors de la plage de défilement, la valeur est arrondie à la valeur valide la plus proche.

lParam

Spécifie si la barre de défilement doit être redessinée pour refléter la nouvelle position de la zone de défilement. Si ce paramètre a la valeur TRUE, la barre de défilement est redessinée. Si elle a la valeur FALSE, la barre de défilement n’est pas redessinée.

Valeur retournée

ComCtl32.dll version 5.0 : si la position de la zone de défilement a changé, la valeur de retour est la position précédente de la zone de défilement ; sinon, il est égal à zéro.

ComCtl32.dll version 6.0 : position actuelle de la zone de défilement, qu’elle ait changé ou non.

Remarques

Si le contrôle de barre de défilement est redessiné par un appel ultérieur à une autre fonction, il est utile de définir le paramètre lParam sur FALSE .

Configuration requise

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 (include Windows.h)

Voir aussi

Référence

SBM_GETPOS

SBM_GETRANGE

SBM_SETRANGE

SBM_SETRANGEREDRAW