Sur cette page

QStyleOptionSlider Class

La classe `QStyleOptionSlider` sert à définir les paramètres nécessaires au tracé d'un curseur. En savoir plus...

En-tête : #include <QStyleOptionSlider>
CMake : find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake : QT += widgets
Hérite de : QStyleOptionComplex

Types publics

enum StyleOptionType { Type }
enum StyleOptionVersion { Version }

Fonctions publiques

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

Variables publiques

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

Description détaillée

QStyleOptionSlider contient toutes les informations dont les fonctions d'QStyle ont besoin pour dessiner QSlider et QScrollBar.

Pour des raisons de performances, il y a peu de fonctions membres et l'accès aux variables membres est direct (c'est-à-dire à l'aide des opérateurs . ou -> ). Cela rend ces structures simples à utiliser et souligne le fait qu'il s'agit simplement de paramètres utilisés par les fonctions de style.

Voir également QStyleOptionComplex, QSlider et QScrollBar.

Documentation sur les types de membres

enum QStyleOptionSlider::StyleOptionType

Cette énumération sert à contenir des informations sur le type de l'option de style et est définie pour chaque sous-classe de ` QStyleOption `.

ConstanteValeurDescription
QStyleOptionSlider::TypeSO_SliderLe type de l'option de style fournie (SO_Slider pour cette classe).

Ce type est utilisé en interne par ` QStyleOption`, ses sous-classes et la méthode ` qstyleoption_cast()` pour déterminer le type de l'option de style. En général, vous n'avez pas à vous en soucier, sauf si vous souhaitez créer votre propre sous-classe de ` QStyleOption ` et vos propres styles.

Voir également StyleOptionVersion.

enum QStyleOptionSlider::StyleOptionVersion

Cette énumération sert à contenir des informations sur la version de l'option de style et est définie pour chaque sous-classe de ` QStyleOption `.

ConstanteValeurDescription
QStyleOptionSlider::Version11

Cette version est utilisée par les sous-classes de ` QStyleOption ` pour implémenter des extensions sans rompre la compatibilité. Si vous utilisez ` qstyleoption_cast()`, vous n’avez normalement pas besoin de la vérifier.

Voir aussi StyleOptionType.

Documentation sur les fonctions membres

QStyleOptionSlider::QStyleOptionSlider()

Crée un objet `QStyleOptionSlider` en initialisant les variables membres à leurs valeurs par défaut.

QStyleOptionSlider::QStyleOptionSlider(const QStyleOptionSlider &other)

Crée une copie de l'option de style « other ».

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

Attribue par copie la classe « other » à cette instance de « QStyleOptionSlider ».

Documentation sur les variables membres

bool QStyleOptionSlider::dialWrapping

Cette variable indique si le cadran doit ou non s'enrouler

La valeur par défaut est « false », c'est-à-dire que le cadran ne s'enroule pas.

Voir également QDial::wrapping().

int QStyleOptionSlider::maximum

Cette variable contient la valeur maximale du curseur

La valeur par défaut est 0.

int QStyleOptionSlider::minimum

Cette variable contient la valeur minimale du curseur

La valeur par défaut est 0.

qreal QStyleOptionSlider::notchTarget

Cette variable contient le nombre de pixels entre les encoches

La valeur par défaut est 0,0.

Voir également QDial::notchTarget().

Qt::Orientation QStyleOptionSlider::orientation

Cette variable contient l'orientation du curseur (horizontale ou verticale)

L'orientation par défaut est Qt::Horizontal.

Voir également Qt::Orientation.

int QStyleOptionSlider::pageStep

Cette variable contient la valeur du pas de la page du curseur

La valeur par défaut est 0.

Voir également QAbstractSlider::pageStep.

int QStyleOptionSlider::singleStep

Cette variable contient la valeur correspondant à la taille d'un pas du curseur

La valeur par défaut est 0.

Voir également QAbstractSlider::singleStep.

int QStyleOptionSlider::sliderPosition

Cette variable contient la position de la poignée du curseur

Si le curseur dispose d'un retour d'information actif (c'est-à-dire si QAbstractSlider::tracking est défini sur true), cette valeur sera identique à sliderValue. Sinon, elle correspondra à la position actuelle du curseur. La valeur par défaut est 0.

Voir également QAbstractSlider::tracking et sliderValue.

int QStyleOptionSlider::sliderValue

Cette variable contient la valeur du curseur

Si le curseur dispose d'un retour d'information actif (c'est-à-dire si la propriété ` QAbstractSlider::tracking ` est définie sur `true`), cette valeur sera identique à celle de ` sliderPosition`. Sinon, elle correspondra à la valeur que le curseur avait avant que le bouton de la souris ne soit enfoncé.

La valeur par défaut est 0.

Voir également QAbstractSlider::tracking et sliderPosition.

int QStyleOptionSlider::tickInterval

Cette variable définit l'intervalle à respecter entre les repères

La valeur par défaut est 0.

QSlider::TickPosition QStyleOptionSlider::tickPosition

Cette variable contient la position des repères du curseur, le cas échéant

La valeur par défaut est QSlider::NoTicks.

Voir également QSlider::TickPosition.

bool QStyleOptionSlider::upsideDown

Cette variable définit l'orientation du curseur

Normalement, la valeur d'un curseur augmente lorsqu'il se déplace vers le haut ou vers la droite ; la valeur « upsideDown » indique qu'il doit se comporter à l'inverse (augmenter lorsqu'il se déplace vers le bas ou vers la gauche). La valeur par défaut est « false », c'est-à-dire que la valeur du curseur augmente lorsqu'il se déplace vers le haut ou vers la droite.

Voir également QStyle::sliderPositionFromValue(), QStyle::sliderValueFromPosition() et 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.