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.