En esta página

QStyleOptionSlider Class

La clase QStyleOptionSlider se utiliza para definir los parámetros necesarios para dibujar un control deslizante. Más información...

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

Tipos públicos

enum StyleOptionType { Type }
enum StyleOptionVersion { Version }

Funciones públicas

QStyleOptionSlider()
QStyleOptionSlider(const QStyleOptionSlider &other)
QStyleOptionSlider &operator=(const QStyleOptionSlider &)

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 necesitan las funciones de QStyle para dibujar QSlider y QScrollBar.

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

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

Documentación sobre los tipos de miembro

enum QStyleOptionSlider::StyleOptionType

Esta enumeración se utiliza para almacenar 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 lo utilizan internamente ` QStyleOption`, sus subclases y ` qstyleoption_cast()` para determinar el tipo de opción de estilo. En general, no es necesario que te preocupes por esto a menos que quieras crear tu propia subclase de ` QStyleOption ` y tus propios estilos.

Véase también StyleOptionVersion.

enum QStyleOptionSlider::StyleOptionVersion

Esta enumeración se utiliza para almacenar información sobre la versión de la opción de estilo y se define para cada subclase de ` QStyleOption `.

ConstanteValorDescripción
QStyleOptionSlider::Version11

Las subclases de ` QStyleOption ` utilizan esta versión para implementar extensiones sin romper la compatibilidad. Si utilizas ` qstyleoption_cast()`, normalmente no es necesario comprobarla.

Véase también StyleOptionType.

Documentación de funciones de miembro

QStyleOptionSlider::QStyleOptionSlider()

Crea un objeto `QStyleOptionSlider` e inicializa las variables de miembro con sus valores por defecto.

QStyleOptionSlider::QStyleOptionSlider(const QStyleOptionSlider &other)

Crea una copia de la opción de estilo « other ».

[noexcept default] QStyleOptionSlider &QStyleOptionSlider::operator=(const QStyleOptionSlider &)

Asigna por copia other a esta instancia de QStyleOptionSlider.

Documentación de variables de miembro

bool QStyleOptionSlider::dialWrapping

Esta variable indica si el dial debe ajustar su anchura o no

El valor por defecto es «false», es decir, el dial no se ajusta.

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

int QStyleOptionSlider::maximum

Esta variable contiene el valor máximo del control deslizante

El valor por defecto es 0.

int QStyleOptionSlider::minimum

Esta variable contiene el valor mínimo del control deslizante

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 control deslizante (horizontal o vertical)

La orientación predeterminada es « Qt::Horizontal ».

Véase también Qt::Orientation.

int QStyleOptionSlider::pageStep

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

El valor por defecto es 0.

Véase también QAbstractSlider::pageStep.

int QStyleOptionSlider::singleStep

Esta variable indica el tamaño de un solo paso del control deslizante

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 control deslizante tiene retroalimentación activa (es decir, si QAbstractSlider::tracking es verdadero), este valor será el mismo que sliderValue. De lo contrario, contendrá la posición actual del control deslizante. El valor por defecto es 0.

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

int QStyleOptionSlider::sliderValue

Esta variable contiene el valor del control deslizante

Si el control deslizante tiene retroalimentación activa (es decir, si ` QAbstractSlider::tracking ` es verdadero), este valor será el mismo que el de ` sliderPosition`. De lo contrario, tendrá el valor que tenía el control deslizante antes de pulsar el botón del ratón.

El valor por defecto es 0.

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

int QStyleOptionSlider::tickInterval

Esta variable indica el intervalo que debe trazarse entre las marcas de escala

El valor por defecto es 0.

QSlider::TickPosition QStyleOptionSlider::tickPosition

Esta variable contiene la posición de las marcas de graduación del control deslizante, si las hay

El valor por defecto es QSlider::NoTicks.

Véase también QSlider::TickPosition.

bool QStyleOptionSlider::upsideDown

Esta variable almacena 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.