QStyleOptionSlider Class
QStyleOptionSlider 类用于描述绘制滑块所需的参数。更多内容...
| 头文件： | #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) | |
| QStyleOptionSlider & | operator=(const QStyleOptionSlider &) |
公共变量
| 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 样式选项的副本。
[noexcept default] QStyleOptionSlider &QStyleOptionSlider::operator=(const QStyleOptionSlider &)
将other 复制并赋值给此QStyleOptionSlider 实例。
成员变量文档
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 ` 为真），则该值将与 `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 。
© 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.
