QScrollBar Class

Descripción detallada

Una barra de desplazamiento es un control que permite al usuario acceder a partes de un documento que es más grande que el widget utilizado para mostrarlo. Proporciona una indicación visual de la posición actual del usuario dentro del documento y la cantidad del documento que es visible. Las barras de desplazamiento suelen ir acompañadas de otros controles que permiten una navegación más precisa. Qt muestra las barras de desplazamiento de un modo apropiado para cada plataforma.

Si necesitas proporcionar una vista de desplazamiento en otro widget, puede ser más conveniente utilizar la clase QScrollArea porque esta proporciona un widget de vista y barras de desplazamiento. QScrollBar es útil si necesitas implementar una funcionalidad similar para widgets especializados utilizando QAbstractScrollArea; por ejemplo, si decides subclasificar QAbstractItemView. Para la mayoría de las otras situaciones en las que se utiliza un control deslizante para obtener un valor dentro de un rango determinado, la clase QSlider puede ser más apropiada para sus necesidades.

Cada barra de desplazamiento tiene un valor que indica a qué distancia se encuentra el deslizador del inicio de la barra de desplazamiento; se obtiene con value() y se fija con setValue(). Este valor siempre se encuentra dentro del rango de valores definidos para la barra de desplazamiento, desde minimum() hasta maximum() inclusive. El rango de valores aceptables puede fijarse con setMinimum() y setMaximum(). En el valor mínimo, el borde superior del deslizador (para una barra de desplazamiento vertical) o el borde izquierdo (para una barra de desplazamiento horizontal) estará en el extremo superior (o izquierdo) de la barra de desplazamiento. En el valor máximo, el borde inferior (o derecho) del deslizador estará en el extremo inferior (o derecho) de la barra de desplazamiento.

La longitud del deslizador suele estar relacionada con el valor del paso de página, y suele representar la proporción del área del documento que se muestra en una vista de desplazamiento. El paso de página es la cantidad en que cambia el valor cuando el usuario pulsa las teclas Page Up y Page Down, y se establece con setPageStep(). Los cambios más pequeños del valor definido por el paso de línea se realizan utilizando las teclas del cursor, y esta cantidad se establece con setSingleStep().

Tenga en cuenta que el rango de valores utilizado es independiente del tamaño real del widget de la barra de desplazamiento. No es necesario tenerlo en cuenta al elegir los valores para el rango y el paso de página.

El rango de valores especificado para la barra de desplazamiento suele determinarse de forma diferente a los de QSlider porque es necesario tener en cuenta la longitud del deslizador. Si tenemos un documento con 100 líneas, y sólo podemos mostrar 20 líneas en un widget, es posible que deseemos construir una barra de desplazamiento con un paso de página de 20, un valor mínimo de 0, y un valor máximo de 80. Esto nos daría una barra de desplazamiento con un paso de página de 20, un valor mínimo de 0, y un valor máximo de 80. Esto nos daría una barra de desplazamiento con cinco "páginas".

La relación entre la longitud de un documento, el rango de valores utilizados en una barra de desplazamiento y el paso de página es sencilla en muchas situaciones comunes. El rango de valores de la barra de desplazamiento se determina restando un paso de página elegido de algún valor que represente la longitud del documento. En tales casos, es útil la siguiente ecuación: longitud del documento = maximum() - minimum() + pageStep().

QScrollBar sólo proporciona rangos enteros. Tenga en cuenta que aunque QScrollBar maneja números muy grandes, las barras de desplazamiento en las pantallas actuales no pueden representar de forma útil rangos por encima de unos 100.000 píxeles. Más allá de eso, se hace difícil para el usuario controlar el deslizador usando el teclado o el ratón, y las flechas de desplazamiento tendrán un uso limitado.

ScrollBar hereda un amplio conjunto de señales de QAbstractSlider:

• valueChanged() se emite cuando el valor de la barra de desplazamiento ha cambiado. La propiedad tracking determina si esta señal se emite durante la interacción con el usuario.
• rangeChanged() se emite cuando el rango de valores de la barra de desplazamiento ha cambiado.
• sliderPressed() se emite cuando el usuario empieza a arrastrar el deslizador.
• sliderMoved() se emite cuando el usuario arrastra el deslizador.
• sliderReleased() se emite cuando el usuario suelta el deslizador.
• actionTriggered() se emite cuando la barra de desplazamiento se modifica por interacción del usuario o mediante la función triggerAction().

Una barra de desplazamiento puede ser controlada por el teclado, pero tiene un valor por defecto focusPolicy() de Qt::NoFocus. Utilice setFocusPolicy() para activar la interacción del teclado con la barra de desplazamiento:

• Izquierda/Derecha mueven una barra de desplazamiento horizontal un solo paso.
• Arriba/Abajo mueve una barra de desplazamiento vertical un solo paso.
• PageUp mueve una página hacia arriba.
• PageDown baja una página.
• Inicio se desplaza al principio (mínimo).
• Fin se desplaza al final (máximo).

El propio deslizador puede controlarse utilizando la función triggerAction() para simular la interacción del usuario con los controles de la barra de desplazamiento. Esto es útil si tienes muchos widgets diferentes que utilizan un rango común de valores.

La mayoría de los estilos GUI utilizan el valor pageStep() para calcular el tamaño del deslizador.