Función SetScrollInfo (winuser.h)
La función SetScrollInfo establece los parámetros de una barra de desplazamiento, incluidas las posiciones de desplazamiento mínima y máxima, el tamaño de página y la posición del cuadro de desplazamiento (pulgar). La función también vuelve a dibujar la barra de desplazamiento, si se solicita.
Sintaxis
int SetScrollInfo(
[in] HWND hwnd,
[in] int nBar,
[in] LPCSCROLLINFO lpsi,
[in] BOOL redraw
);
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 fnBar .
[in] nBar
Tipo: int
Especifica el tipo de barra de desplazamiento para la que se van a establecer parámetros. Este parámetro puede ser uno de los valores siguientes.
[in] lpsi
Tipo: LPCSCROLLINFO
Puntero a una estructura SCROLLINFO . Antes de llamar a SetScrollInfo, establezca el miembro cbSize de la estructura en sizeof(SCROLLINFO), establezca el miembro fMask para indicar los parámetros que se van a establecer y especifique los nuevos valores de parámetro en los miembros adecuados.
El miembro fMask puede ser uno o varios de los valores siguientes.
| Value | Significado |
|---|---|
|
Deshabilita la barra de desplazamiento en lugar de quitarla, si los nuevos parámetros de la barra de desplazamiento hacen que la barra de desplazamiento no sea necesaria. |
|
Establece la página de desplazamiento en el valor especificado en el miembro nPage de la estructura SCROLLINFO a la que apunta lpsi. |
|
Establece la posición de desplazamiento en el valor especificado en el miembro nPos de la estructura SCROLLINFO a la que apunta lpsi. |
|
Establece el intervalo de desplazamiento en el valor especificado en los miembros nMin y nMax de la estructura SCROLLINFO a la que apunta lpsi. |
[in] redraw
Tipo: BOOL
Especifica si la barra de desplazamiento se vuelve a dibujar para reflejar los cambios en la barra de desplazamiento. Si este parámetro es TRUE, la barra de desplazamiento se vuelve a dibujar; de lo contrario, no se vuelve a dibujar.
Valor devuelto
Tipo: int
El valor devuelto es la posición actual del cuadro de desplazamiento.
Observaciones
La función SetScrollInfo realiza la comprobación de intervalos en los valores especificados por los miembros nPage y nPos de la estructura SCROLLINFO . El miembro nPage debe especificar un valor de 0 a nMax - nMin +1. El miembro nPos debe especificar un valor entre nMin y nMax - max( nPage– 1, 0). Si cualquiera de los valores está fuera de su intervalo, la función la establece en un valor que se encuentra justo dentro del intervalo.
Si el parámetro fnBar 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_SETSCROLLINFO a la ventana para establecer la información de la barra de desplazamiento (el sistema puede optimizar el mensaje para SBM_SETPOS o SBM_SETRANGE si la solicitud es únicamente para la posición o el intervalo). Esto permite que SetScrollInfo funcione en un control personalizado que imita una barra de desplazamiento. Si la ventana no controla SBM_SETSCROLLINFO (o el mensaje de SBM_SETPOS optimizado o SBM_SETRANGE ), se produce un error en la función SetScrollInfo .
Para obtener un ejemplo, vea Scrolling Text with the WM_PAINT Message.
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) |
Consulte también
Referencia