winuser.h


GetScrollRange

La función GetScrollRange recupera los valores de las posiciones mínimas y máximas de la caja de desplazamiento (thumb) de una barra de desplazamiento especificada.

Para Windows 95, esta función existe por compatibilidad con versiones de sistemas operativos anteriores a la 4.0. Para la versión 4.0 o superiores, debe usarse la función GetScrollInfo.

Sintaxis

BOOL GetScrollRange(
    HWND hWnd,       // manipulador de la ventana con la barra de desplazamiento
    int nBar,        // bandera de barra de desplazamiento
    LPINT lpMinPos,  // dirección de la variable que recibe la posición mínima
    LPINT lpMaxPos   // dirección de la variable que recibe la posición máxima
   );

Parámetros:

hWnd: identifica el control de barra de desplazamiento o la ventana con una barra de desplazamiento estándar, dependiendo del valor del parámetro nBar.

nBar: especifica el scrollbar cuyos valores de rango queremos recuperar. Puede tener uno de los siguientes valores:

Valor Significado
SB_CTL Recupera el rango de un control de barra de desplazamiento. El parámetro hwnd debe ser el manipulador del control de barra de desplazamiento.
SB_HORZ Recupera el rango de la barra de desplazamiento horizontal estándar de una ventana.
SB_VERT Recupera el rango de la barra de desplazamiento vertical estándar de una ventana.

lpMinPos: apunta a una variable entera que recibirá la posición mínima de desplazamiento.

lpMaxPos: apunta a una variable entera que recibirá la posición máxima de desplazamiento.

Valor de retorno

Si la función tiene éxito, el valor de retorno es distinto de cero.

Si falla, el valor de retorno es cero. Para conseguir más información, se puede llamar a GetLastError.

Observaciones

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

El rango por defecto de una barra de desplazamiento estándar es de 0 a 100. Para controles de barra de desplazamiento es un rango vacío (ambos valores son cero).

Los mensajes que indican posiciones de scrollbar, WM_HSCROLL y WM_HSCROLL, están limitados a 16 bits para el dato de la posición. Sin embargo, como las funciones SetScrollPos, SetScrollRange, GetScrollPos y GetScrollRange soportan valores de 32-bit para el dato de la posición, existe un modo de sortear la barrera de 16-bit de los mensajes WM_HSCROLL y WM_VSCROLL. Ver GetScrollPos para ver una descripción de esa técnica y sus límites.