Función GetScrollPos (winuser.h)

La función GetScrollPos recupera la posición actual del cuadro de desplazamiento (pulgar) en la barra de desplazamiento especificada. La posición actual es un valor relativo que depende del intervalo de desplazamiento actual. Por ejemplo, si el intervalo de desplazamiento es de 0 a 100 y el cuadro de desplazamiento está en medio de la barra, la posición actual es de 50.

Sintaxis

int GetScrollPos(
  [in] HWND hWnd,
  [in] int  nBar
);

Parámetros

[in] hWnd

Tipo: HWND

Controle un control de barra de desplazamiento o una ventana con una barra de desplazamiento estándar, en función del valor del parámetro nBar .

[in] nBar

Tipo: int

Especifica la barra de desplazamiento que se va a examinar. Este parámetro puede ser uno de los valores siguientes.

Valor devuelto

Tipo: int

Si la función se ejecuta correctamente, el valor devuelto es la posición actual del cuadro de desplazamiento.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

La función GetScrollPos permite a las aplicaciones usar posiciones de desplazamiento de 32 bits. Aunque los mensajes que indican la posición de la barra de desplazamiento, WM_HSCROLL y WM_VSCROLL, están limitados a 16 bits de datos de posición, las funciones SetScrollPos, SetScrollRange, GetScrollPos y GetScrollRange admiten datos de posición de barra de desplazamiento de 32 bits. Por lo tanto, una aplicación puede llamar a GetScrollPos mientras procesa el WM_HSCROLL o WM_VSCROLL mensajes 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 , use la función GetScrollInfo .

Si el parámetro nBar es SB_CTL y la ventana especificada por el parámetro hWnd no es un control de barra de desplazamiento del sistema, el sistema envía el mensaje SBM_GETPOS a la ventana para obtener información de la barra de desplazamiento. Esto permite que GetScrollPos funcione en un control personalizado que imita una barra de desplazamiento. Si la ventana no controla el mensaje de SBM_GETPOS , se produce un error en la función GetScrollPos .

Requisitos

Consulte también

GetScrollInfo

GetScrollRange

Referencia

SetScrollInfo

SetScrollPos

SetScrollRange

WM_HSCROLL

WM_VSCROLL