Función SetScrollInfo (winuser.h)

  • Artículo

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.

Valor Significado
SB_CTL
 Establece los parámetros de un control de barra de desplazamiento. El parámetro hwnd debe ser el identificador del control de barra de desplazamiento.
SB_HORZ
 Establece los parámetros de la barra de desplazamiento horizontal estándar de la ventana.
SB_VERT
 Establece los parámetros de la barra de desplazamiento vertical estándar de la ventana.

[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
SIF_DISABLENOSCROLL
 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.
SIF_PAGE
 Establece la página de desplazamiento en el valor especificado en el miembro nPage de la estructura SCROLLINFO a la que apunta lpsi.
SIF_POS
 Establece la posición de desplazamiento en el valor especificado en el miembro nPos de la estructura SCROLLINFO a la que apunta lpsi.
SIF_RANGE
 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

GetScrollInfo

Referencia

SCROLLINFO