Mensaje de WM_VSCROLL

El mensajeWM_VSCROLL se envía a una ventana cuando se produce un evento de desplazamiento en la barra de desplazamiento vertical estándar de la ventana. Este mensaje también se envía al propietario de un control de barra de desplazamiento vertical cuando se produce un evento de desplazamiento en el control.

Una ventana recibe este mensaje mediante la función WindowProc.

WM_VSCROLL

    WPARAM wParam
    LPARAM lParam; 

Parámetros

wParam

El HIWORDespecifica la posición actual del cuadro de desplazamiento si LOWORD es SB_THUMBPOSITION o SB_THUMBTRACK; de lo contrario, no se usa esta palabra.

El LOWORD especifica un valor de barra de desplazamiento que indica la solicitud de desplazamiento del usuario. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
SB_BOTTOM
Se desplaza a la parte inferior derecha.
SB_ENDSCROLL
Finaliza el desplazamiento.
SB_LINEDOWN
Desplaza una línea hacia abajo.
SB_LINEUP
Desplaza una línea hacia arriba.
SB_PAGEDOWN
Desplaza una página hacia abajo.
SB_PAGEUP
Desplaza una página hacia arriba.
SB_THUMBPOSITION
El usuario ha arrastrado el cuadro de desplazamiento (pulgar) y ha liberado el botón del mouse. El HIWORD indica la posición del cuadro de desplazamiento al final de la operación de arrastre.
SB_THUMBTRACK
El usuario está arrastrando el cuadro de desplazamiento. Este mensaje se envía repetidamente hasta que el usuario suelta el botón del mouse. El HiWORD indica la posición a la que se ha arrastrado el cuadro de desplazamiento.
SB_TOP
Se desplaza a la esquina superior izquierda.

lParam

Si un control de barra de desplazamiento envía el mensaje, este parámetro es el identificador del control de barra de desplazamiento. Si una barra de desplazamiento estándar envía el mensaje, este parámetro es NULL.

Valor devuelto

Si la aplicación procesa este mensaje, debe devolver cero.

Comentarios

Normalmente, las aplicaciones que proporcionan comentarios usan el código de solicitud SB_THUMBTRACK cuando el usuario arrastra el cuadro de desplazamiento.

Si una aplicación desplaza el contenido de la ventana, también debe restablecer la posición del cuadro de desplazamiento mediante la función SetScrollPos.

Tenga en cuenta que el mensaje WM_VSCROLL contiene solo 16 bits de datos de posición del cuadro de desplazamiento. Por lo tanto, las aplicaciones que se basan únicamente en WM_VSCROLL (y WM_HSCROLL) para los datos de posición de desplazamiento tienen un valor de posición máximo práctico de 65,535.

Sin embargo, dado que las funciones SetScrollInfo, SetScrollPos, SetScrollRange, GetScrollInfo, GetScrollPos y GetScrollRange admiten datos de posición de barra de desplazamiento de 32 bits, hay una manera de eludir la barrera de 16 bits de los mensajes de WM_HSCROLL y WM_VSCROLL. Consulte GetScrollInfo para obtener una descripción de la técnica.

Requisitos

Requisito Valor
Cliente mínimo compatible
Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible
Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado
Winuser.h (incluya Windows.h)

Consulte también

Referencia

GetScrollInfo

GetScrollPos

GetScrollRange

SetScrollInfo

SetScrollPos

SetScrollRange

WM_HSCROLL

WM_VSCROLL (barra de seguimiento)