Oharra
Baimena behar duzu orria atzitzeko. Direktorioetan saioa has dezakezu edo haiek alda ditzakezu.
Baimena behar duzu orria atzitzeko. Direktorioak alda ditzakezu.
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