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.

[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

Consulte también

GetScrollInfo

Referencia

SCROLLINFO