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
- tickInterval : int
- tickPosition : TickPosition
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

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ñal | Descripció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.
| Constante | Valor | Descripción |
|---|---|---|
QSlider::NoTicks | 0 | No dibujar ninguna marca de graduación. |
QSlider::TicksBothSides | 3 | Dibuja marcas de graduación a ambos lados de la ranura. |
QSlider::TicksAbove | 1 | Dibuja marcas de graduación por encima del control deslizante (horizontal) |
QSlider::TicksBelow | 2 | Dibuja marcas de graduación debajo del control deslizante (horizontal) |
QSlider::TicksLeft | TicksAbove | Dibuja marcas a la izquierda del control deslizante (vertical) |
QSlider::TicksRight | TicksBelow | Dibuja 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.