Función GetScrollPos (winuser.h)

Artículo
08/27/2023

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.

Nota La función GetScrollPos se proporciona para la compatibilidad con versiones anteriores. Las nuevas aplicaciones deben usar la función GetScrollInfo .

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	Significado
SB_CTL	Recupera la posición del cuadro de desplazamiento en un control de barra de desplazamiento. El parámetro hWnd debe ser el identificador del control de barra de desplazamiento.
SB_HORZ	Recupera la posición del cuadro de desplazamiento en la barra de desplazamiento horizontal estándar de una ventana.
SB_VERT	Recupera la posición del cuadro de desplazamiento en la barra de desplazamiento vertical estándar de una ventana.

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


Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-misc-l1-2-0 (introducido en Windows 8.1)