Función GetScrollRange (winuser.h)

Artículo
08/27/2023

La función GetScrollRange recupera las posiciones actuales del cuadro de desplazamiento mínimo y máximo (pulgar) de la barra de desplazamiento especificada.

Nota La función GetScrollRange solo se proporciona por motivos de compatibilidad. Las nuevas aplicaciones deben usar la función GetScrollInfo .

Sintaxis

BOOL GetScrollRange(
  [in]  HWND  hWnd,
  [in]  int   nBar,
  [out] LPINT lpMinPos,
  [out] LPINT lpMaxPos
);

Parámetros

[in] hWnd

Tipo: HWND

Controle un control de barra de desplazamiento o una ventana con una barra de desplazamiento estándar, según el valor del parámetro nBar .

[in] nBar

Tipo: int

Especifica la barra de desplazamiento desde la que se recuperan las posiciones. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
SB_CTL	Recupera las posiciones de un control de barra de desplazamiento. El parámetro hWnd debe ser el identificador del control de barra de desplazamiento.
SB_HORZ	Recupera las posiciones de la barra de desplazamiento horizontal estándar de la ventana.
SB_VERT	Recupera las posiciones de la barra de desplazamiento vertical estándar de la ventana.

[out] lpMinPos

Tipo: LPINT

Puntero a la variable de entero que recibe la posición mínima.

[out] lpMaxPos

Tipo: LPINT

Puntero a la variable de entero que recibe la posición máxima.

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

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

Comentarios

Si la ventana especificada no tiene barras de desplazamiento estándar o no es un control de barra de desplazamiento, la función GetScrollRange copia cero en los parámetros lpMinPos y lpMaxPos .

El intervalo predeterminado de una barra de desplazamiento estándar es de 0 a 100. El intervalo predeterminado de un control de barra de desplazamiento está vacío (ambos valores son cero).

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. Sin embargo, dado que 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 la función GetScrollInfo para obtener una descripción de la técnica.

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_GETRANGE a la ventana para obtener información de la barra de desplazamiento. Esto permite que GetScrollRange funcione en un control personalizado que imita una barra de desplazamiento. Si la ventana no controla el mensaje de SBM_GETRANGE , se produce un error en la función GetScrollRange .

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 (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll