En esta página

QSlider Class

El widget QSlider ofrece un control deslizante vertical u horizontal. Más información...

Encabezado: #include <QSlider>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredado de: QAbstractSlider

Tipos públicos

enum TickPosition { NoTicks, TicksBothSides, TicksAbove, TicksBelow, TicksLeft, TicksRight }

Propiedades

Funciones públicas

QSlider(QWidget *parent = nullptr)
QSlider(Qt::Orientation orientation, QWidget *parent = nullptr)
virtual ~QSlider()
void setTickInterval(int ti)
void setTickPosition(QSlider::TickPosition position)
int tickInterval() const
QSlider::TickPosition tickPosition() const

Funciones públicas reimplementadas

virtual bool event(QEvent *event) override
virtual QSize minimumSizeHint() const override
virtual QSize sizeHint() const override

Funciones protegidas

virtual void initStyleOption(QStyleOptionSlider *option) const

Funciones protegidas reimplementadas

virtual void mouseMoveEvent(QMouseEvent *ev) override
virtual void mousePressEvent(QMouseEvent *ev) override
virtual void mouseReleaseEvent(QMouseEvent *ev) override
virtual void paintEvent(QPaintEvent *ev) override

Descripción detallada

Control deslizante horizontal con marcas de referencia

El control deslizante es el widget clásico para controlar un valor acotado. Permite al usuario mover un controlador a lo largo de una ranura horizontal o vertical y traduce la posición del controlador en un valor entero dentro del rango válido.

QSlider tiene muy pocas funciones propias; la mayor parte de la funcionalidad se encuentra en QAbstractSlider. Las funciones más útiles son setValue() para establecer el control deslizante directamente en un valor determinado; triggerAction() para simular los efectos de hacer clic (útil para teclas de acceso rápido); setSingleStep(), setPageStep() para establecer los pasos; y setMinimum() y setMaximum() para definir el rango de la barra de desplazamiento.

QSlider proporciona métodos para controlar las marcas de graduación. Puedes utilizar setTickPosition() para indicar dónde quieres que estén las marcas de graduación, y setTickInterval() para indicar cuántas quieres. La posición y el intervalo de las marcas de graduación establecidos actualmente se pueden consultar utilizando las funciones tickPosition() y tickInterval(), respectivamente.

QSlider hereda un amplio conjunto de señales:

SeñalDescripción
valueChanged()Se emite cuando cambia el valor del control deslizante. La función tracking() determina si esta señal se emite durante la interacción del usuario.
sliderPressed()Se emite cuando el usuario empieza a arrastrar el control deslizante.
sliderMoved()Se emite cuando el usuario arrastra el control deslizante.
sliderReleased()Se emite cuando el usuario suelta el control deslizante.

QSlider solo admite rangos de números enteros. Ten en cuenta que, aunque QSlider maneja números muy grandes, a los usuarios les resulta difícil utilizar el control deslizante con precisión en rangos muy amplios.

Un control deslizante acepta el foco mediante la tecla Tab y ofrece tanto una interfaz para la rueda del ratón como para el teclado. La interfaz de teclado es la siguiente:

  • Izquierda/Derecha: mueven un control deslizante horizontal un solo paso.
  • Las teclas Arriba/Abajo mueven un control deslizante vertical un solo paso.
  • «Re Pág» se desplaza una página hacia arriba.
  • «Av Pág» se desplaza una página hacia abajo.
  • Inicio se desplaza al principio (mínimo).
  • Fin: se desplaza hasta el final (máximo).

Véase también QScrollBar, QSpinBox, QDial y el ejemplo de controles deslizantes.

Documentación sobre tipos de miembros

enum QSlider::TickPosition

Esta enumeración especifica dónde deben dibujarse las marcas de graduación en relación con la ranura del control deslizante y el tirador que mueve el usuario.

ConstanteValorDescripción
QSlider::NoTicks0No dibujar ninguna marca de graduación.
QSlider::TicksBothSides3Dibuja marcas de graduación a ambos lados de la ranura.
QSlider::TicksAbove1Dibuja marcas de graduación por encima del control deslizante (horizontal)
QSlider::TicksBelow2Dibuja marcas de graduación debajo del control deslizante (horizontal)
QSlider::TicksLeftTicksAboveDibuja marcas a la izquierda del control deslizante (vertical)
QSlider::TicksRightTicksBelowDibuja marcas de graduación a la derecha del control deslizante (vertical)

Documentación de propiedades

tickInterval : int

Esta propiedad define el intervalo entre las marcas de escala

Se trata de un intervalo de valores, no de píxeles. Si se establece en 0, el control deslizante elegirá entre singleStep y pageStep.

El valor por defecto es « 0 ». Los valores negativos no son válidos y, por lo tanto, se limitan a « 0 ».

Funciones de acceso:

int tickInterval() const
void setTickInterval(int ti)

Véase también « tickPosition », « singleStep » y « pageStep ».

tickPosition : TickPosition

Esta propiedad almacena la posición de la marca de referencia de este control deslizante

Los valores válidos se describen en la enumeración « QSlider::TickPosition ».

El valor por defecto es QSlider::NoTicks.

Funciones de acceso:

QSlider::TickPosition tickPosition() const
void setTickPosition(QSlider::TickPosition position)

Véase también ` tickInterval`.

Documentación de las funciones de miembro

[explicit] QSlider::QSlider(QWidget *parent = nullptr)

Crea un control deslizante vertical con el valor dado parent.

[explicit] QSlider::QSlider(Qt::Orientation orientation, QWidget *parent = nullptr)

Crea un control deslizante con el valor dado en « parent ». El parámetro « orientation » determina si el control deslizante es horizontal o vertical; los valores válidos son « Qt::Vertical » y « Qt::Horizontal ».

[virtual noexcept] QSlider::~QSlider()

Elimina este control deslizante.

[override virtual] bool QSlider::event(QEvent *event)

Reimplementa: ` QAbstractSlider::event(QEvent *e)`.

[virtual protected] void QSlider::initStyleOption(QStyleOptionSlider *option) const

Inicializa ` option ` con los valores de esta página: QSlider. Este método resulta útil para las subclases cuando necesitan un ` QStyleOptionSlider`, pero no desean rellenar toda la información por sí mismas.

Véase también QStyleOption::initFrom().

[override virtual] QSize QSlider::minimumSizeHint() const

Reimplementa una función de acceso para la propiedad: QWidget::minimumSizeHint.

[override virtual protected] void QSlider::mouseMoveEvent(QMouseEvent *ev)

Reimplementa: ` QWidget::mouseMoveEvent(QMouseEvent *event)`.

[override virtual protected] void QSlider::mousePressEvent(QMouseEvent *ev)

Reimplementa: ` QWidget::mousePressEvent(QMouseEvent *event)`.

[override virtual protected] void QSlider::mouseReleaseEvent(QMouseEvent *ev)

Reimplementa: ` QWidget::mouseReleaseEvent(QMouseEvent *event)`.

[override virtual protected] void QSlider::paintEvent(QPaintEvent *ev)

Reimplementa: QWidget::paintEvent(QPaintEvent *event).

[override virtual] QSize QSlider::sizeHint() const

Reimplementa una función de acceso para la propiedad: QWidget::sizeHint.

© 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.