QStyleOptionSlider Class
QStyleOptionSlider 类用于描述绘制滑块所需的参数。更多
| Header： | #include <QStyleOptionSlider> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake： | QT += widgets |
| 继承： | QStyleOptionComplex |
公共类型
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
公共函数
| QStyleOptionSlider() | |
| QStyleOptionSlider(const QStyleOptionSlider &other) |
公共变量
| 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 |
详细说明
QStyleOptionSlider 包含QStyle 函数绘制QSlider 和QScrollBar 所需的所有信息。
出于性能考虑，成员函数很少，对成员变量的访问是直接的（即使用. 或-> 操作符）。这使得这些结构使用起来简单明了，并强调这些结构只是样式函数使用的参数。
另请参见 QStyleOptionComplex,QSlider, 和QScrollBar 。
成员类型文档
enum QStyleOptionSlider::StyleOptionType
该枚举用于保存有关样式选项类型的信息，并为每个QStyleOption 子类定义。
| 常量 | 值 | 描述 |
|---|---|---|
QStyleOptionSlider::Type | SO_Slider | 提供的样式选项的类型（SO_Slider 适用于该类）。 |
QStyleOption 及其子类和qstyleoption_cast() 内部使用该类型来确定样式选项的类型。一般来说，除非您想创建自己的QStyleOption 子类和自己的样式，否则不需要担心这个问题。
另请参见 StyleOptionVersion 。
enum QStyleOptionSlider::StyleOptionVersion
该枚举用于保存有关样式选项版本的信息，并为每个QStyleOption 子类定义。
| 常量 | 值 | 说明 |
|---|---|---|
QStyleOptionSlider::Version | 1 | 1 |
该版本用于QStyleOption 子类在不破坏兼容性的情况下实现扩展。如果使用qstyleoption_cast() ，通常不需要检查它。
另请参阅 StyleOptionType 。
成员函数文档
QStyleOptionSlider::QStyleOptionSlider()
构造一个 QStyleOptionSlider，将成员变量初始化为默认值。
QStyleOptionSlider::QStyleOptionSlider(const QStyleOptionSlider &other)
构建other 样式选项的副本。
成员变量文档
bool QStyleOptionSlider::dialWrapping
该变量用于保存刻度盘是否包边。
默认值为 false，即表盘不包边。
另请参阅 QDial::wrapping().
int QStyleOptionSlider::maximum
该变量用于保存滑块的最大值。
默认值为 0。
int QStyleOptionSlider::minimum
该变量用于保存滑块的最小值。
默认值为 0。
qreal QStyleOptionSlider::notchTarget
该变量用于保存凹槽之间的像素数。
默认值为 0.0。
另请参见 QDial::notchTarget()。
Qt::Orientation QStyleOptionSlider::orientation
该变量用于保存滑块的方向（水平或垂直）。
默认方向为Qt::Horizontal 。
另请参见 Qt::Orientation 。
int QStyleOptionSlider::pageStep
该变量用于保存滑块页面步长的大小。
默认值为 0。
另请参见 QAbstractSlider::pageStep 。
int QStyleOptionSlider::singleStep
该变量用于保存滑块单步的大小。
默认值为 0。
另请参见 QAbstractSlider::singleStep 。
int QStyleOptionSlider::sliderPosition
该变量用于保存滑块手柄的位置。
如果滑块有主动反馈（即QAbstractSlider::tracking 为 true），该值将与sliderValue 相同。否则，该值就是手柄的当前位置。默认值为 0。
另请参阅 QAbstractSlider::tracking 和sliderValue 。
int QStyleOptionSlider::sliderValue
该变量保存滑块的值
如果滑块有主动反馈（即QAbstractSlider::tracking 为 true），该值将与sliderPosition 相同。否则，该值将是滑块在按下鼠标之前的值。
默认值为 0。
另请参见 QAbstractSlider::tracking 和sliderPosition 。
int QStyleOptionSlider::tickInterval
该变量用于保存刻度线之间的间隔。
默认值为 0。
QSlider::TickPosition QStyleOptionSlider::tickPosition
该变量保存滑块刻度线的位置（如果有的话
默认值为QSlider::NoTicks 。
另请参见 QSlider::TickPosition 。
bool QStyleOptionSlider::upsideDown
该变量用于保存滑块控制方向
通常情况下，滑块向上或向右移动时会增加；而 upsideDown 则表示滑块的方向相反（向下或向左移动时会增加）。默认值为 false，即滑块向上或向右移动时会增加。
另请参阅 QStyle::sliderPositionFromValue()、QStyle::sliderValueFromPosition() 和QAbstractSlider::invertedAppearance 。
© 2025 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.
