Scroll Bar

Artículo
06/13/2023

Esta sección contiene información sobre los elementos de programación usados con barras de desplazamiento. Una ventana puede mostrar un objeto de datos, como un documento o un mapa de bits, que es mayor que el área de cliente de la ventana. Cuando se proporciona con una barra de desplazamiento, el usuario puede desplazar un objeto de datos en el área de cliente para incluir en la vista las partes del objeto que se extienden más allá de los bordes de la ventana.

Temas de introducción

Tema	Contenido
Acerca de las barras de desplazamiento	Una barra de desplazamiento consta de un eje sombreado con un botón de flecha en cada extremo y un cuadro de desplazamiento (a veces denominado pulgar) entre los botones de flecha.
Uso de barras de desplazamiento	Al crear una ventana secundaria, emergente o superpuesta, puede agregar barras de desplazamiento estándar mediante la función CreateWindowEx y especificando WS_HSCROLL, WS_VSCROLL o ambos estilos.

Functions

Tema	Contenido
EnableScrollBar	La función EnableScrollBar habilita o deshabilita una o ambas flechas de barra de desplazamiento.
GetScrollBarInfo	La función GetScrollBarInfo recupera información sobre la barra de desplazamiento especificada.
GetScrollInfo	La función GetScrollInfo recupera 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).
GetScrollPos	La función GetScrollPos recupera la posición actual del cuadro de desplazamiento (pulgar) en la barra de desplazamiento especificada. La posición actual es un valor relativo que depende del intervalo de desplazamiento actual. Por ejemplo, si el intervalo de desplazamiento es de 0 a 100 y el cuadro de desplazamiento está en medio de la barra, la posición actual es de 50. Nota: La función GetScrollPos se proporciona para la compatibilidad con versiones anteriores. Las nuevas aplicaciones deben usar la función GetScrollInfo .
GetScrollRange	La función GetScrollRange recupera las posiciones actuales del cuadro de desplazamiento mínimo y máximo (pulgar) de la barra de desplazamiento especificada. Nota: La función GetScrollRange solo se proporciona por compatibilidad. Las nuevas aplicaciones deben usar la función GetScrollInfo .
ScrollDC	La función ScrollDC desplaza un rectángulo de bits horizontal y verticalmente.
ScrollWindow	La función ScrollWindow desplaza el contenido del área de cliente de la ventana especificada. Nota: La función ScrollWindow se proporciona para la compatibilidad con versiones anteriores. Las nuevas aplicaciones deben usar la función ScrollWindowEx .
ScrollWindowEx	La función ScrollWindowEx desplaza el contenido del área de cliente de la ventana especificada.
SetScrollInfo	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.
SetScrollPos	La función SetScrollPos establece la posición del cuadro de desplazamiento (pulgar) en la barra de desplazamiento especificada y, si se solicita, vuelve a dibujar la barra de desplazamiento para reflejar la nueva posición del cuadro de desplazamiento. Nota: La función SetScrollPos se proporciona para la compatibilidad con versiones anteriores. Las nuevas aplicaciones deben usar la función SetScrollInfo .
SetScrollRange	La función SetScrollRange establece las posiciones del cuadro de desplazamiento mínimo y máximo para la barra de desplazamiento especificada. Nota: La función SetScrollRange se proporciona para la compatibilidad con versiones anteriores. Las nuevas aplicaciones deben usar la función SetScrollInfo .
ShowScrollBar	La función ShowScrollBar muestra u oculta la barra de desplazamiento especificada.

error de Hadoop

Tema	Contenido
SBM_ENABLE_ARROWS	Una aplicación envía el mensaje SBM_ENABLE_ARROWS para habilitar o deshabilitar una o ambas flechas de un control de barra de desplazamiento.
SBM_GETPOS	El mensaje SBM_GETPOS se envía para recuperar la posición actual del cuadro de desplazamiento de un control de barra de desplazamiento. La posición actual es un valor relativo que depende del intervalo de desplazamiento actual. Por ejemplo, si el intervalo de desplazamiento es de 0 a 100 y el cuadro de desplazamiento está en medio de la barra, la posición actual es de 50. Las aplicaciones no deben enviar este mensaje directamente. En su lugar, deben usar la función GetScrollPos . Una ventana recibe este mensaje a través de la función WindowProc. Las aplicaciones que implementan un control de barra de desplazamiento personalizado deben responder a estos mensajes para que la función GetScrollPos funcione correctamente.
SBM_GETRANGE	El mensaje SBM_GETRANGE se envía para recuperar los valores de posición mínimo y máximo para el control de barra de desplazamiento. Las aplicaciones no deben enviar este mensaje directamente. En su lugar, deben usar la función GetScrollRange . Una ventana recibe este mensaje a través de la función WindowProc. Las aplicaciones que implementan un control de barra de desplazamiento personalizado deben responder a estos mensajes para que la función GetScrollRange funcione correctamente.
SBM_GETSCROLLBARINFO	Enviado por una aplicación para recuperar información sobre la barra de desplazamiento especificada.
SBM_GETSCROLLINFO	El mensaje SBM_GETSCROLLINFO se envía para recuperar los parámetros de una barra de desplazamiento. Las aplicaciones no deben enviar este mensaje directamente. En su lugar, deben usar la función GetScrollInfo . Una ventana recibe este mensaje a través de la función WindowProc. Las aplicaciones que implementan un control de barra de desplazamiento personalizado deben responder a estos mensajes para que la función GetScrollInfo funcione correctamente.
SBM_SETPOS	El mensaje de SBM_SETPOS se envía para establecer la posición del cuadro de desplazamiento (pulgar) y, si se solicita, vuelva a dibujar la barra de desplazamiento para reflejar la nueva posición del cuadro de desplazamiento. Las aplicaciones no deben enviar este mensaje directamente. En su lugar, deben usar la función SetScrollPos . Una ventana recibe este mensaje a través de la función WindowProc. Las aplicaciones que implementan un control de barra de desplazamiento personalizado deben responder a estos mensajes para que la función SetScrollPos funcione correctamente.
SBM_SETRANGE	El SBM_SETRANGE mensaje se envía para establecer los valores de posición mínimo y máximo para el control de barra de desplazamiento. Las aplicaciones no deben enviar este mensaje directamente. En su lugar, deben usar la función SetScrollRange . Una ventana recibe este mensaje a través de la función WindowProc. Las aplicaciones que implementan un control de barra de desplazamiento personalizado deben responder a estos mensajes para que la función SetScrollRange funcione correctamente.
SBM_SETRANGEREDRAW	Una aplicación envía el mensaje SBM_SETRANGEREDRAW a un control de barra de desplazamiento para establecer los valores de posición mínimo y máximo y volver a dibujar el control.
SBM_SETSCROLLINFO	El mensaje SBM_SETSCROLLINFO se envía para establecer los parámetros de una barra de desplazamiento. Las aplicaciones no deben enviar este mensaje directamente. En su lugar, deben usar la función SetScrollInfo . Una ventana recibe este mensaje a través de la función WindowProc. Las aplicaciones que implementan un control de barra de desplazamiento personalizado deben responder a estos mensajes para que la función SetScrollInfo funcione correctamente.

Notificaciones

Tema	Contenido
WM_CTLCOLORSCROLLBAR	El mensaje WM_CTLCOLORSCROLLBAR se envía a la ventana primaria de un control de barra de desplazamiento cuando el control está a punto de dibujarse. Al responder a este mensaje, la ventana primaria puede usar el identificador de contexto de visualización para establecer el color de fondo del control de barra de desplazamiento. Una ventana recibe este mensaje a través de la función WindowProc.
WM_HSCROLL	El mensaje WM_HSCROLL se envía a una ventana cuando se produce un evento de desplazamiento en la barra de desplazamiento horizontal estándar de la ventana. Este mensaje también se envía al propietario de un control de barra de desplazamiento horizontal cuando se produce un evento de desplazamiento en el control. Una ventana recibe este mensaje a través de la función WindowProc.
WM_VSCROLL	El mensaje WM_VSCROLL se envía a una ventana cuando se produce un evento de desplazamiento en la barra de desplazamiento vertical estándar de la ventana. Este mensaje también se envía al propietario de un control de barra de desplazamiento vertical cuando se produce un evento de desplazamiento en el control. Una ventana recibe este mensaje a través de la función WindowProc.

Estructuras

Tema	Contenido
SCROLLBARINFO	La estructura SCROLLBARINFO contiene información de la barra de desplazamiento.
SCROLLINFO	La estructura SCROLLINFO contiene parámetros de barra de desplazamiento que se van a establecer mediante la función SetScrollInfo (o SBM_SETSCROLLINFO mensaje) o recuperada por la función GetScrollInfo (o SBM_GETSCROLLINFO mensaje).

Constantes

Tema	Contenido
Estilos de control de barra de desplazamiento	Para crear un control de barra de desplazamiento mediante la función CreateWindow o CreateWindowEx , especifique la clase SCROLLBAR, las constantes de estilo de ventana adecuadas y una combinación de los siguientes estilos de control de barra de desplazamiento. Algunos de los estilos crean un control de barra de desplazamiento que usa un ancho o alto predeterminados. Sin embargo, siempre debe especificar las coordenadas x e y y de la otra dimensión de la barra de desplazamiento al llamar a CreateWindow o CreateWindowEx.

Tema

Contenido

Estilos de control de barra de desplazamiento

Para crear un control de barra de desplazamiento mediante la función CreateWindow o CreateWindowEx , especifique la clase SCROLLBAR, las constantes de estilo de ventana adecuadas y una combinación de los siguientes estilos de control de barra de desplazamiento. Algunos de los estilos crean un control de barra de desplazamiento que usa un ancho o alto predeterminados. Sin embargo, siempre debe especificar las coordenadas x e y y de la otra dimensión de la barra de desplazamiento al llamar a CreateWindow o CreateWindowEx.