Compartir vía


mensaje de SBM_GETSCROLLINFO

El mensaje SBM_GETSCROLLINFO se envía para recuperar los parámetros de una barra de desplazamiento.

Las aplicaciones no deben enviar este mensaje directamente. En su lugar, deben usar la función GetScrollInfo . Una ventana recibe este mensaje a través de la función WindowProc. Las aplicaciones que implementan un control de barra de desplazamiento personalizado deben responder a estos mensajes para que la función GetScrollInfo funcione correctamente.

Parámetros

wParam

Este parámetro no se utiliza.

lParam

Puntero a una estructura SCROLLINFO . Antes de llamar a GetScrollInfo, establezca el miembro cbSize de la estructura en sizeof(SCROLLINFO) y establezca el miembro fMask para especificar los parámetros de la barra de desplazamiento que se van a recuperar. Antes de devolverlo, el mensaje copia los parámetros especificados en los miembros adecuados de la estructura.

El miembro fMask puede ser uno o varios de los valores siguientes.

Value Significado
SIF_ALL
Combinación de SIF_PAGE, SIF_POS, SIF_RANGE y SIF_TRACKPOS.
SIF_PAGE
Copia la página de desplazamiento al miembro nPage.
SIF_POS
Copia la posición de desplazamiento en el miembro nPos.
SIF_RANGE
Copia el intervalo de desplazamiento a los miembros nMin y nMax.
SIF_TRACKPOS
Copia la posición de seguimiento del cuadro de desplazamiento actual en el miembro nTrackPos.

Valor devuelto

Si el mensaje recuperó algún valor, el valor devuelto es TRUE; de lo contrario, es FALSE.

Observaciones

Los mensajes que indican la posición de la barra de desplazamiento, WM_HSCROLL y WM_VSCROLL, proporcionan solo 16 bits de datos de posición. Sin embargo, la estructura SCROLLINFO usada por SBM_GETSCROLLINFO, SBM_SETSCROLLINFO, GetScrollInfo y SetScrollInfo proporciona 32 bits de datos de posición de barra de desplazamiento. Puede usar estos mensajes y funciones mientras procesa los mensajes de WM_HSCROLL o WM_VSCROLL para obtener datos de posición de la barra de desplazamiento de 32 bits.

Para obtener la posición de 32 bits del cuadro de desplazamiento (pulgar) durante un código de solicitud de SB_THUMBTRACK en un mensaje de WM_HSCROLL o WM_VSCROLL , envíe SBM_GETSCROLLINFO con el valor SIF_TRACKPOS en el miembro fMask de la estructura SCROLLINFO . El mensaje devuelve la posición de seguimiento del cuadro de desplazamiento en el miembro nTrackPos de la estructura SCROLLINFO . Esto le permite obtener la posición del cuadro de desplazamiento a medida que el usuario lo mueve. Como alternativa, puede usar la función GetScrollInfo para obtener la misma información.

Requisitos

Requisito Value
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

SBM_SETSCROLLINFO

SCROLLINFO

SetScrollInfo