En esta página

QStyleOptionSlider Class

La clase QStyleOptionSlider se utiliza para describir los parámetros necesarios para dibujar un deslizador. Más...

Cabecera: #include <QStyleOptionSlider>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Hereda: QStyleOptionComplex

Tipos Públicos

enum StyleOptionType { Type }
enum StyleOptionVersion { Version }

Funciones Públicas

QStyleOptionSlider()
QStyleOptionSlider(const QStyleOptionSlider &other)

Variables Públicas

bool dialWrapping
int maximum
int minimum
qreal notchTarget
Qt::Orientation orientation
int pageStep
int singleStep
int sliderPosition
int sliderValue
int tickInterval
QSlider::TickPosition tickPosition
bool upsideDown

Descripción Detallada

QStyleOptionSlider contiene toda la información que las funciones QStyle necesitan para dibujar QSlider y QScrollBar.

Por razones de rendimiento, hay pocas funciones miembro y el acceso a las variables miembro es directo (es decir, utilizando el operador . o -> ). Esto hace que las estructuras sean fáciles de usar y pone de relieve que se trata simplemente de parámetros utilizados por las funciones de estilo.

Véase también QStyleOptionComplex, QSlider, y QScrollBar.

Documentación de tipos de miembros

enum QStyleOptionSlider::StyleOptionType

Este enum se utiliza para guardar información sobre el tipo de la opción de estilo, y se define para cada subclase de QStyleOption.

ConstanteValorDescripción
QStyleOptionSlider::TypeSO_SliderEl tipo de opción de estilo proporcionada (SO_Slider para esta clase).

El tipo es utilizado internamente por QStyleOption, sus subclases y qstyleoption_cast() para determinar el tipo de opción de estilo. En general no necesitas preocuparte por esto a menos que quieras crear tu propia subclase QStyleOption y tus propios estilos.

Véase también StyleOptionVersion.

enum QStyleOptionSlider::StyleOptionVersion

Este enum se utiliza para guardar información sobre la versión de la opción de estilo, y se define para cada subclase de QStyleOption.

ConstanteValorDescripción
QStyleOptionSlider::Version11

La versión es utilizada por las subclases de QStyleOption para implementar extensiones sin romper la compatibilidad. Si utiliza qstyleoption_cast(), normalmente no necesita comprobarla.

Véase también StyleOptionType.

Documentación de funciones miembro

QStyleOptionSlider::QStyleOptionSlider()

Construye un QStyleOptionSlider, inicializando las variables miembros a sus valores por defecto.

QStyleOptionSlider::QStyleOptionSlider(const QStyleOptionSlider &other)

Construye una copia de la opción de estilo other.

Documentación de la variable miembro

bool QStyleOptionSlider::dialWrapping

Esta variable indica si la esfera debe envolverse o no.

El valor por defecto es false, es decir, el dial no se envuelve.

Véase también QDial::wrapping().

int QStyleOptionSlider::maximum

Esta variable contiene el valor máximo para el deslizador

El valor por defecto es 0.

int QStyleOptionSlider::minimum

Esta variable contiene el valor mínimo para el deslizador

El valor por defecto es 0.

qreal QStyleOptionSlider::notchTarget

Esta variable contiene el número de píxeles entre muescas

El valor por defecto es 0.0.

Véase también QDial::notchTarget().

Qt::Orientation QStyleOptionSlider::orientation

Esta variable contiene la orientación del deslizador (horizontal o vertical)

La orientación por defecto es Qt::Horizontal.

Véase también Qt::Orientation.

int QStyleOptionSlider::pageStep

Esta variable contiene el tamaño del paso de página del deslizador

El valor por defecto es 0.

Véase también QAbstractSlider::pageStep.

int QStyleOptionSlider::singleStep

Esta variable contiene el tamaño del paso individual del deslizador

El valor por defecto es 0.

Véase también QAbstractSlider::singleStep.

int QStyleOptionSlider::sliderPosition

Esta variable contiene la posición del control deslizante.

Si el deslizador tiene retroalimentación activa (es decir, QAbstractSlider::tracking es verdadero), este valor será el mismo que sliderValue. En caso contrario, tendrá la posición actual del tirador. El valor por defecto es 0.

Véase también QAbstractSlider::tracking y sliderValue.

int QStyleOptionSlider::sliderValue

Esta variable contiene el valor del deslizador

Si el deslizador tiene retroalimentación activa (es decir, QAbstractSlider::tracking es verdadero), este valor será el mismo que sliderPosition. En caso contrario, tendrá el valor que tenía el deslizador antes de que se pulsara el ratón.

El valor por defecto es 0.

Véase también QAbstractSlider::tracking y sliderPosition.

int QStyleOptionSlider::tickInterval

Esta variable contiene el intervalo que debe dibujarse entre las marcas de graduación.

El valor por defecto es 0.

QSlider::TickPosition QStyleOptionSlider::tickPosition

Esta variable contiene la posición de las marcas del deslizador, si las hay.

El valor por defecto es QSlider::NoTicks.

Véase también QSlider::TickPosition.

bool QStyleOptionSlider::upsideDown

Esta variable contiene la orientación del control deslizante

Normalmente, un control deslizante aumenta a medida que se desplaza hacia arriba o hacia la derecha; upsideDown indica que debe hacer lo contrario (aumentar a medida que se desplaza hacia abajo o hacia la izquierda). El valor por defecto es false, es decir, el control deslizante aumenta a medida que se desplaza hacia arriba o hacia la derecha.

Véase también QStyle::sliderPositionFromValue(), QStyle::sliderValueFromPosition(), y QAbstractSlider::invertedAppearance.

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