QStyleOptionTab Class
QStyleOptionTab 类用于描述绘制标签栏的参数。更多内容...
| 头文件： | #include <QStyleOptionTab> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake： | QT += widgets |
| 继承自： | QStyleOption |
公共类型
| enum | CornerWidget { NoCornerWidgets, LeftCornerWidget, RightCornerWidget } |
| flags | CornerWidgets |
| enum | SelectedPosition { NotAdjacent, NextIsSelected, PreviousIsSelected } |
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
| enum | TabFeature { None, HasFrame, MinimumSizeHint } |
| flags | TabFeatures |
| enum | TabPosition { Beginning, Middle, End, OnlyOneTab, Moving } |
公共函数
| QStyleOptionTab() | |
| QStyleOptionTab(const QStyleOptionTab &other) | |
| QStyleOptionTab & | operator=(const QStyleOptionTab &) |
公共变量
| QStyleOptionTab::CornerWidgets | cornerWidgets |
| bool | documentMode |
| QIcon | icon |
| QSize | iconSize |
| QSize | leftButtonSize |
| QStyleOptionTab::TabPosition | position |
| QSize | rightButtonSize |
| int | row |
| QStyleOptionTab::SelectedPosition | selectedPosition |
| QTabBar::Shape | shape |
| int | tabIndex |
| QString | text |
详细说明
QStyleOptionTab 类用于绘制几个内置的 Qt Widgets，包括QTabBar 以及QTabWidget 的面板。
QStyleOptionTab 类的实例具有type 、SO_Tab 和version 3。该类型由QStyleOption 、其子类以及qstyleoption_cast() 在内部使用，以确定样式选项的类型。 通常情况下，除非您想创建自己的QStyleOption 子类和自定义样式，否则无需担心这一点。版本号被QStyleOption 的子类用于在不破坏兼容性的前提下实现扩展。如果您使用qstyleoption_cast()，通常无需检查该参数。
出于性能考虑，成员函数较少，且对成员变量的访问是直接的（即使用. 或-> 运算符）。这使得这些结构体的使用非常直观，同时也强调了它们仅仅是样式函数所使用的参数。
另请参阅 QStyleOption 。
成员类型文档
enum QStyleOptionTab::CornerWidget
flags QStyleOptionTab::CornerWidgets
这些标记表示选项卡中的角控件。
| 常量 | 值 | 描述 |
|---|---|---|
QStyleOptionTab::NoCornerWidgets | 0x00 | 没有角落小部件 |
QStyleOptionTab::LeftCornerWidget | 0x01 | 左上角小部件 |
QStyleOptionTab::RightCornerWidget | 0x02 | 右角控件 |
CornerWidgets 类型是QFlags<CornerWidget> 的 typedef 定义。它存储 CornerWidget 值的按“或”运算组合。
另请参阅 cornerWidgets 。
enum QStyleOptionTab::SelectedPosition
此枚举描述了所选选项卡的位置。某些样式需要根据选项卡是否与所选选项卡相邻，以不同的方式绘制该选项卡。
| 常量 | 值 | 描述 |
|---|---|---|
QStyleOptionTab::NotAdjacent | 0 | 该选项卡未与选中选项卡相邻（或该选项卡本身即为选中选项卡）。 |
QStyleOptionTab::NextIsSelected | 1 | 下一个标签页（通常是右侧的标签页）被选中。 |
QStyleOptionTab::PreviousIsSelected | 2 | 选中了上一个选项卡（通常是左侧的选项卡）。 |
另请参阅 selectedPosition 。
enum QStyleOptionTab::StyleOptionType
该枚举用于存储样式选项类型的相关信息，并针对每个QStyleOption 子类分别定义。
| 常量 | 常量值 | 描述 |
|---|---|---|
QStyleOptionTab::Type | SO_Tab | 提供的样式选项的类型（对于此类而言为SO_Tab ）。 |
该类型由QStyleOption 、其子类以及qstyleoption_cast()在内部使用，以确定样式选项的类型。通常情况下，除非您想创建自己的QStyleOption 子类和自己的样式，否则无需担心此问题。
另请参阅 StyleOptionVersion 。
enum QStyleOptionTab::StyleOptionVersion
该枚举用于存储样式选项的版本信息，并针对每个QStyleOption 子类分别定义。
| 常量 | 常量值 | 描述 |
|---|---|---|
QStyleOptionTab::Version | 1 | 3 |
QStyleOption 子类使用该版本号来实现扩展，同时保持兼容性。如果您使用qstyleoption_cast()，通常无需检查该版本号。
另请参阅 StyleOptionType 。
enum QStyleOptionTab::TabFeature
flags QStyleOptionTab::TabFeatures
描述了选项卡按钮可能具备的各种功能。
| 常量 | 值 | 描述 |
|---|---|---|
QStyleOptionTab::None | 0x00 | 一个普通的选项卡按钮。 |
QStyleOptionTab::HasFrame | 0x01 | 该选项卡按钮位于选项卡框架上 |
QStyleOptionTab::MinimumSizeHint (since Qt 6.9) | 0x02 | 正在测量该选项卡按钮的最小尺寸提示，这与其常规尺寸提示不同。 |
TabFeatures 类型是QFlags<TabFeature> 的 typedef。它存储 TabFeature 值的按“或”运算组合。
另请参阅 QStyleOptionToolBar::features 。
enum QStyleOptionTab::TabPosition
此枚举描述了选项卡的位置。
| 常量 | 值 | 描述 |
|---|---|---|
QStyleOptionTab::Beginning | 0 | 该标签是标签栏中的第一个标签。 |
QStyleOptionTab::Middle | 1 | 该标签既不是标签栏中的第一个标签，也不是最后一个标签。 |
QStyleOptionTab::End | 2 | 该标签是标签栏中的最后一个标签。 |
QStyleOptionTab::OnlyOneTab | 3 | 该标签页既是标签栏中的第一个标签页，也是最后一个标签页。 |
QStyleOptionTab::Moving (since Qt 6.6) | 4 | 该标签页正在通过鼠标拖拽或动画效果移动。 |
另请参阅 position 。
成员函数文档
QStyleOptionTab::QStyleOptionTab()
创建一个 QStyleOptionTab 对象，并将成员变量初始化为默认值。
QStyleOptionTab::QStyleOptionTab(const QStyleOptionTab &other)
创建other 样式选项的副本。
[noexcept default] QStyleOptionTab &QStyleOptionTab::operator=(const QStyleOptionTab &)
将other 复制并赋值给此QStyleOptionTab 实例。
成员变量文档
QStyleOptionTab::CornerWidgets QStyleOptionTab::cornerWidgets
该变量包含CornerWidget 值的“或”组合，用于指定标签栏的角控件
默认值为NoCornerWidgets 。
另请参阅 ` CornerWidget`。
bool QStyleOptionTab::documentMode
该变量用于表示标签栏是否处于文档模式。
默认值为 false；
QIcon QStyleOptionTab::icon
该变量存储标签页的图标
其默认值是一个空图标，即既没有位图也没有文件名的图标。
QSize QStyleOptionTab::iconSize
该变量用于存储图标的大小
默认值为QSize （-1, -1），即一个无效的尺寸；请使用QStyle::pixelMetric()来获取标签栏的默认图标尺寸。
另请参阅 QTabBar::iconSize()。
QSize QStyleOptionTab::leftButtonSize
该变量存储标签页中左侧控件的大小。
默认值为QSize （-1, -1），即一个无效的大小；
QStyleOptionTab::TabPosition QStyleOptionTab::position
该变量存储标签在标签栏中的位置
默认值为Beginning ，即该标签是标签栏中的第一个标签。
QSize QStyleOptionTab::rightButtonSize
该变量存储标签页上右侧控件的大小。
默认值为QSize （-1, -1），即一个无效的尺寸；
int QStyleOptionTab::row
该变量用于存储选项卡当前所在的行
默认值为 0，表示第一行。目前该属性只能取值为 0。
QStyleOptionTab::SelectedPosition QStyleOptionTab::selectedPosition
该变量存储了所选标签页相对于当前标签页的位置
默认值为NotAdjacent ，即该标签页既不与选中标签页相邻，也不是选中标签页本身。
QTabBar::Shape QStyleOptionTab::shape
该变量存储用于绘制标签的标签形状；默认值为QTabBar::RoundedNorth 。
另请参阅 QTabBar::Shape 。
int QStyleOptionTab::tabIndex
该变量存储所表示的标签页的索引。
默认值为 -1，即不在标签栏上的标签页；
QString QStyleOptionTab::text
该变量存储选项卡的文本
其默认值为空字符串。
© 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.
