QAbstractSlider Class
La clase QAbstractSlider proporciona un valor entero dentro de un intervalo. Más información...
| Encabezado: | #include <QAbstractSlider> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredado de: | QWidget |
| Heredado por: | QDial, ` QScrollBar` y QSlider |
Tipos públicos
| enum | SliderAction { SliderNoAction, SliderSingleStepAdd, SliderSingleStepSub, SliderPageStepAdd, SliderPageStepSub, …, SliderMove } |
Propiedades
|
|
Funciones públicas
| QAbstractSlider(QWidget *parent = nullptr) | |
| virtual | ~QAbstractSlider() |
| bool | hasTracking() const |
| bool | invertedAppearance() const |
| bool | invertedControls() const |
| bool | isSliderDown() const |
| int | maximum() const |
| int | minimum() const |
| Qt::Orientation | orientation() const |
| int | pageStep() const |
| void | setInvertedAppearance(bool) |
| void | setInvertedControls(bool) |
| void | setMaximum(int) |
| void | setMinimum(int) |
| void | setPageStep(int) |
| void | setSingleStep(int) |
| void | setSliderDown(bool) |
| void | setSliderPosition(int) |
| void | setTracking(bool enable) |
| int | singleStep() const |
| int | sliderPosition() const |
| void | triggerAction(QAbstractSlider::SliderAction action) |
| int | value() const |
Ranuras públicas
| void | setOrientation(Qt::Orientation) |
| void | setRange(int min, int max) |
| void | setValue(int) |
Señales
| void | actionTriggered(int action) |
| void | rangeChanged(int min, int max) |
| void | sliderMoved(int value) |
| void | sliderPressed() |
| void | sliderReleased() |
| void | valueChanged(int value) |
Tipos protegidos
| enum | SliderChange { SliderRangeChange, SliderOrientationChange, SliderStepsChange, SliderValueChange } |
Funciones protegidas
| QAbstractSlider::SliderAction | repeatAction() const |
| void | setRepeatAction(QAbstractSlider::SliderAction action, int thresholdTime = 500, int repeatTime = 50) |
| virtual void | sliderChange(QAbstractSlider::SliderChange change) |
Funciones protegidas reimplementadas
| virtual void | changeEvent(QEvent *ev) override |
| virtual bool | event(QEvent *e) override |
| virtual void | keyPressEvent(QKeyEvent *ev) override |
| virtual void | timerEvent(QTimerEvent *e) override |
| virtual void | wheelEvent(QWheelEvent *e) override |
Descripción detallada
La clase está diseñada como una superclase común para widgets como QScrollBar, QSlider y QDial.
Estas son las principales propiedades de la clase:
- value: El entero acotado que mantiene QAbstractSlider.
- minimum: El valor más bajo posible.
- maximum: El valor máximo posible.
- singleStep: El menor de los dos incrementos naturales que ofrece un control deslizante abstracto y que, por lo general, se corresponde con la pulsación de una tecla de flecha por parte del usuario.
- pageStep: El mayor de los dos incrementos naturales que ofrece un control deslizante abstracto y que suele corresponder a que el usuario pulse las teclas AvPág o RePág.
- tracking: Indica si está activado el seguimiento del control deslizante.
- sliderPosition: La posición actual del control deslizante. Si está activada la opción « tracking » (por defecto), esto es idéntico a « value ».
La unidad (1) puede considerarse como un tercer tamaño de paso. « setValue()» permite establecer el valor actual en cualquier número entero dentro del rango permitido, no solo en « minimum() + n * singleStep()» para valores enteros de n. Algunos widgets pueden permitir al usuario establecer cualquier valor; otros pueden limitarse a ofrecer múltiplos de « singleStep()» o « pageStep()».
QAbstractSlider emite un conjunto completo de señales:
| Señal | Se emite cuando |
|---|---|
| valueChanged() | el valor ha cambiado. El ` tracking ` determina si esta señal se emite durante la interacción del usuario. |
| sliderPressed() | el usuario empieza a arrastrar el control deslizante. |
| sliderMoved() | el usuario arrastra el control deslizante. |
| sliderReleased() | el usuario suelta el control deslizante. |
| actionTriggered() | Se ha activado una acción del control deslizante. |
| rangeChanged() | El rango ha cambiado. |
QAbstractSlider proporciona una función virtual sliderChange() que resulta muy adecuada para actualizar la representación en pantalla de los controles deslizantes. Al llamar a triggerAction(), las subclases activan las acciones del control deslizante. Dos funciones auxiliares, QStyle::sliderPositionFromValue() y QStyle::sliderValueFromPosition(), ayudan a las subclases y a los estilos a asignar coordenadas de pantalla a valores de rango lógicos.
Véase también QAbstractSpinBox, QSlider, QDial, QScrollBar y el ejemplo de controles deslizantes.
Documentación sobre tipos de miembros
enum QAbstractSlider::SliderAction
| Constante | Valor |
|---|---|
QAbstractSlider::SliderNoAction | 0 |
QAbstractSlider::SliderSingleStepAdd | 1 |
QAbstractSlider::SliderSingleStepSub | 2 |
QAbstractSlider::SliderPageStepAdd | 3 |
QAbstractSlider::SliderPageStepSub | 4 |
QAbstractSlider::SliderToMinimum | 5 |
QAbstractSlider::SliderToMaximum | 6 |
QAbstractSlider::SliderMove | 7 |
enum QAbstractSlider::SliderChange
| Constante | Valor |
|---|---|
QAbstractSlider::SliderRangeChange | 0 |
QAbstractSlider::SliderOrientationChange | 1 |
QAbstractSlider::SliderStepsChange | 2 |
QAbstractSlider::SliderValueChange | 3 |
Documentación de la propiedad
invertedAppearance : bool
Esta propiedad determina si un control deslizante muestra sus valores invertidos o no.
Si esta propiedad tiene el valor « false » (por defecto), los valores mínimo y máximo se mostrarán en su posición clásica para el control heredado. Si el valor es «true», los valores mínimo y máximo aparecerán en su posición opuesta.
Nota: Esta propiedad tiene más sentido para los controles deslizantes y los diales. En el caso de las barras de desplazamiento, el efecto visual de los subcontroles de la barra de desplazamiento depende de si los estilos admiten o no la apariencia invertida; la mayoría de los estilos ignoran esta propiedad en las barras de desplazamiento.
Funciones de acceso:
| bool | invertedAppearance() const |
| void | setInvertedAppearance(bool) |
invertedControls : bool
Esta propiedad determina si el control deslizante invierte o no los eventos de la rueda del ratón y de las teclas.
Si esta propiedad tiene el valor « false », al desplazar la rueda del ratón «hacia arriba» y utilizar teclas como «Av Pág», el valor del control deslizante aumentará hasta su máximo. De lo contrario, al pulsar «Av Pág», el valor se desplazará hacia el mínimo del control deslizante.
Funciones de acceso:
| bool | invertedControls() const |
| void | setInvertedControls(bool) |
maximum : int
Esta propiedad establece el valor máximo del control deslizante
Al configurar esta propiedad, el « minimum » se ajusta, si es necesario, para garantizar que el rango siga siendo válido. Asimismo, el valor actual del control deslizante se ajusta para que se encuentre dentro del nuevo rango.
Funciones de acceso:
| int | maximum() const |
| void | setMaximum(int) |
minimum : int
Esta propiedad establece el valor mínimo del control deslizante
Al configurar esta propiedad, se ajusta el « maximum » (rango de valores) si es necesario para garantizar que el rango siga siendo válido. Asimismo, se ajusta el valor actual del control deslizante para que se encuentre dentro del nuevo rango.
Funciones de acceso:
| int | minimum() const |
| void | setMinimum(int) |
orientation : Qt::Orientation
Esta propiedad define la orientación del control deslizante
La orientación debe ser « Qt::Vertical » (valor predeterminado) o « Qt::Horizontal ».
Funciones de acceso:
| Qt::Orientation | orientation() const |
| void | setOrientation(Qt::Orientation) |
pageStep : int
Esta propiedad contiene el paso de página.
Es el mayor de los dos pasos naturales que ofrece un control deslizante abstracto y, por lo general, se corresponde con la pulsación de las teclas AvPág o RePág por parte del usuario.
Funciones de Access:
| int | pageStep() const |
| void | setPageStep(int) |
Véase también « singleStep ».
singleStep : int
Esta propiedad representa el paso único.
Es el más pequeño de los dos pasos naturales que ofrece un control deslizante abstracto y, por lo general, se corresponde con la pulsación de una tecla de flecha por parte del usuario.
Si se modifica la propiedad durante un evento de tecla de repetición automática, el comportamiento es indefinido.
Funciones de acceso:
| int | singleStep() const |
| void | setSingleStep(int) |
Véase también pageStep.
sliderDown : bool
Esta propiedad indica si el control deslizante está pulsado.
Las subclases establecen esta propiedad para indicar al control deslizante abstracto si la señal « tracking » tiene algún efecto o no.
Al modificar la propiedad «slider down», se emiten las señales « sliderPressed()» y « sliderReleased()».
Funciones de acceso:
| bool | isSliderDown() const |
| void | setSliderDown(bool) |
sliderPosition : int
Esta propiedad almacena la posición actual del control deslizante
Si está activada la opción « tracking » (por defecto), es idéntica a « value ».
Funciones de acceso:
| int | sliderPosition() const |
| void | setSliderPosition(int) |
Señal de notificación:
| void | sliderMoved(int value) |
tracking : bool
Esta propiedad indica si el seguimiento del control deslizante está activado
Si el seguimiento está activado (por defecto), el control deslizante emite la señal « valueChanged()» mientras se arrastra. Si el seguimiento está desactivado, el control deslizante emite la señal « valueChanged()» únicamente cuando el usuario suelta el control deslizante.
Funciones de acceso:
| bool | hasTracking() const |
| void | setTracking(bool enable) |
Véase también sliderDown.
value : int
Esta propiedad contiene el valor actual del control deslizante
El control deslizante garantiza que el valor se encuentre dentro del rango válido: minimum <= value <= maximum.
Al cambiar el valor, también cambia sliderPosition.
Funciones de acceso:
| int | value() const |
| void | setValue(int) |
Señal de notificación:
| void | valueChanged(int value) |
Documentación de la función miembro
[explicit] QAbstractSlider::QAbstractSlider(QWidget *parent = nullptr)
Crea un control deslizante abstracto.
El argumento « parent » se envía al constructor « QWidget ».
El valor predeterminado de « minimum » es 0, el de « maximum » es 99, el tamaño de « singleStep » es 1, el de « pageStep » es 10 y el valor inicial de « value » es 0.
[virtual noexcept] QAbstractSlider::~QAbstractSlider()
Elimina el control deslizante.
[signal] void QAbstractSlider::actionTriggered(int action)
Esta señal se emite cuando se activa la acción del control deslizante « action ». Las acciones son « SliderSingleStepAdd », « SliderSingleStepSub », « SliderPageStepAdd », « SliderPageStepSub », « SliderToMinimum », « SliderToMaximum » y « SliderMove ».
Cuando se emite la señal, el ` sliderPosition ` se ha ajustado según la acción, pero el ` value ` aún no se ha propagado (lo que significa que la señal ` valueChanged()` aún no se ha emitido), y la visualización aún no se ha actualizado. Por lo tanto, en los slots conectados a esta señal puedes ajustar de forma segura cualquier acción llamando tú mismo a ` setSliderPosition()` en función tanto de la acción como del valor del control deslizante.
Véase también ` triggerAction()`.
[override virtual protected] void QAbstractSlider::changeEvent(QEvent *ev)
Reimplementa: ` QWidget::changeEvent(QEvent *event)`.
[override virtual protected] bool QAbstractSlider::event(QEvent *e)
Reimplementa: ` QWidget::event(QEvent *event)`.
[override virtual protected] void QAbstractSlider::keyPressEvent(QKeyEvent *ev)
Reimplementa: ` QWidget::keyPressEvent(QKeyEvent *event)`.
[signal] void QAbstractSlider::rangeChanged(int min, int max)
Esta señal se emite cuando ha cambiado el rango del control deslizante, siendo min el nuevo mínimo y max el nuevo máximo.
Véanse también minimum y maximum.
[protected] QAbstractSlider::SliderAction QAbstractSlider::repeatAction() const
Devuelve la acción de repetición actual.
Véase también setRepeatAction().
[slot] void QAbstractSlider::setRange(int min, int max)
Establece el valor mínimo del control deslizante en min y su valor máximo en max.
Si max es menor que min, min pasa a ser el único valor válido.
Véase también minimum y maximum.
[protected] void QAbstractSlider::setRepeatAction(QAbstractSlider::SliderAction action, int thresholdTime = 500, int repeatTime = 50)
Configura la acción « action » para que se active de forma repetitiva a intervalos de repeatTime, tras un retraso inicial de thresholdTime.
Véase también triggerAction() y repeatAction().
[virtual protected] void QAbstractSlider::sliderChange(QAbstractSlider::SliderChange change)
Reimplementa esta función virtual para realizar un seguimiento de los cambios en el control deslizante, como SliderRangeChange, SliderOrientationChange, SliderStepsChange o SliderValueChange. La implementación por defecto solo actualiza la visualización e ignora el parámetro change.
[signal] void QAbstractSlider::sliderMoved(int value)
Esta señal se emite cuando ` sliderDown ` es verdadero y el control deslizante se mueve. Esto suele ocurrir cuando el usuario arrastra el control deslizante. ` value ` es la nueva posición del control deslizante.
Esta señal se emite incluso cuando el seguimiento está desactivado.
Nota: Señalde notificación para la propiedad sliderPosition.
Véase también setTracking(), valueChanged(), isSliderDown(), sliderPressed() y sliderReleased().
[signal] void QAbstractSlider::sliderPressed()
Esta señal se emite cuando el usuario pulsa el control deslizante con el ratón, o mediante programación cuando se llama a ` setSliderDown` (true).
Véase también sliderReleased(), sliderMoved() y isSliderDown().
[signal] void QAbstractSlider::sliderReleased()
Esta señal se emite cuando el usuario suelta el control deslizante con el ratón, o mediante programación cuando se llama a « setSliderDown » (false).
Véase también sliderPressed(), sliderMoved() y sliderDown.
[override virtual protected] void QAbstractSlider::timerEvent(QTimerEvent *e)
Reimplementa: QObject::timerEvent(QTimerEvent *event).
void QAbstractSlider::triggerAction(QAbstractSlider::SliderAction action)
Activa un control deslizante action. Las acciones posibles son SliderSingleStepAdd, SliderSingleStepSub, SliderPageStepAdd, SliderPageStepSub, SliderToMinimum, SliderToMaximum y SliderMove.
Véase también actionTriggered().
[signal] void QAbstractSlider::valueChanged(int value)
Esta señal se emite cuando cambia el valor del control deslizante, con el nuevo control deslizante value como argumento.
Nota: Señalde notificación para la propiedad value.
[override virtual protected] void QAbstractSlider::wheelEvent(QWheelEvent *e)
Reimplementa: QWidget::wheelEvent(QWheelEvent *event).
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.