En esta página

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:

  1. value: El entero acotado que mantiene QAbstractSlider.
  2. minimum: El valor más bajo posible.
  3. maximum: El valor máximo posible.
  4. 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.
  5. 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.
  6. tracking: Indica si está activado el seguimiento del control deslizante.
  7. 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ñalSe 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

ConstanteValor
QAbstractSlider::SliderNoAction0
QAbstractSlider::SliderSingleStepAdd1
QAbstractSlider::SliderSingleStepSub2
QAbstractSlider::SliderPageStepAdd3
QAbstractSlider::SliderPageStepSub4
QAbstractSlider::SliderToMinimum5
QAbstractSlider::SliderToMaximum6
QAbstractSlider::SliderMove7

enum QAbstractSlider::SliderChange

ConstanteValor
QAbstractSlider::SliderRangeChange0
QAbstractSlider::SliderOrientationChange1
QAbstractSlider::SliderStepsChange2
QAbstractSlider::SliderValueChange3

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.