SetScrollInfo
La función SetScrollInfo cambia los parámetros de una barra de desplazamiento, incluyendo las posiciones mínima y máxima de desplazamiento, el tamaño de la página y la posición de la caja de desplazamiento (thumb). También redibuja la barra de desplazamiento, si se requiere.
Sintaxis
int SetScrollInfo(
HWND hwnd, // manipulador de la ventana con el scrollbar
int fnBar, // bandera de barra de desplazamiento
LPSCROLLINFO lpsi, // puntero a estructura con los parámetros de desplazamiento
BOOL fRedraw // bandera de repintado
);
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 fnBar.
fnBar: especifica el tipo de barra de desplazamiento cuyos parámetros se modificarán. Puede tener uno de los siguientes valores:
| Valor | Significado |
|---|---|
| SB_CTL | Cambia los parámetros de un control de barra de desplazamiento. El parámetro hwnd debe ser un manipulador del control de barra de desplazamiento. |
| SB_HORZ | Cambia los parámetros de la barra de desplazamiento estándar horizontal de una ventana. |
| SB_VERT | Cambia los parámetros de la barra de desplazamiento estándar vertical de una ventana. |
lpsi: puntero a una estructura SCROLLINFO cuyo miembro fMask, especifica los parámetros de la barra de desplazamiento a modificar.
El miembro fMask puede ser una combinación de los siguientes valores:
| Valor | Significado |
|---|---|
| SIF_DISABLENOSCROLL | Deshabilita la barra de desplazamiento en lugar de eliminarlo, si los nuevos parámetros hacen que la barra de desplazamiento sea innecesaria. |
| SIF_PAGE | Cambia el valor de la página de desplazamiento al valor especificado por el miembro nPage de la estructura SCROLLINFO apuntada por lpsi. |
| SIF_POS | Cambia el valor de la posición de desplazamiento al valor especificado por el miembro nPos de la estructura SCROLLINFO apuntada por lpsi. |
| SIF_RANGE | Cambia el rango de desplazamiento al valor especificado por los miembros nMin y nMax de la estructura SCROLLINFO apuntada por lpsi. |
fRedraw: especifica si la barra de desplazamiento debe ser redibujada para reflejar el cambio. Si es TRUE, será redibujada. Si es FALSE, no.
Valor de retorno
El valor de retorno es la posición actual de la caja de desplazamiento.
Observaciones
La función SetScrollInfo realiza una comprobación de los valores especificados por los miembros nPage y nPos de la estructura SCROLLINFO. El miembro nPage debe especificar un valor entre 0 y nMax - nMin +1. El miembro nPos debe especificar un valor entre nMin y nMax - max(nPage - 1, 0). Si alguno de esos valores está fuera de rango, la función cambia su valor para que tenga un valor permitido.