QStyleOptionTab Class
QStyleOptionTab 类用于描述绘制标签栏的参数。更多
| Header： | #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::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 Widget，包括QTabBar 和QTabWidget 的面板。
QStyleOptionTab 类的实例有type SO_Tab 和version 3。QStyleOption 及其子类和qstyleoption_cast() 在内部使用该类型来确定样式选项的类型。一般来说，除非您想创建自己的QStyleOption 子类和自己的样式，否则无需担心这个问题。QStyleOption 子类使用该版本实现扩展，而不会破坏兼容性。如果使用qstyleoption_cast() ，通常不需要检查它。
出于性能考虑，成员函数很少，对成员变量的访问是直接的（即使用. 或-> 操作符）。这使得结构简单易用，并强调这些只是样式函数使用的参数。
另请参见 QStyleOption 。
成员类型文档
枚举 QStyleOptionTab::CornerWidget
标志 QStyleOptionTab::CornerWidgets
这些标志表示标签页中的边角部件。
| 常量 | 值 | 说明 |
|---|---|---|
QStyleOptionTab::NoCornerWidgets | 0x00 | 没有角部件 |
QStyleOptionTab::LeftCornerWidget | 0x01 | 左角部件 |
QStyleOptionTab::RightCornerWidget | 0x02 | 右角部件 |
CornerWidgets 类型是QFlags<CornerWidget> 的类型定义。它存储了 CornerWidget 值的 OR 组合。
另请参阅 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 。
枚举 QStyleOptionTab::TabFeature
标志 QStyleOptionTab::TabFeatures
描述标签按钮的各种特性。
| 常量 | 值 | 描述 |
|---|---|---|
QStyleOptionTab::None | 0x00 | 一个普通的标签按钮。 |
QStyleOptionTab::HasFrame | 0x01 | 标签按钮位于标签框上 |
QStyleOptionTab::MinimumSizeHint (since Qt 6.9) | 0x02 | 正在测量标签按钮的最小尺寸提示，这与常规尺寸提示不同。 |
TabFeatures 类型是QFlags<TabFeature> 的类型定义。它存储 TabFeature 值的 OR 组合。
另请参阅 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 样式选项的副本。
成员变量文档
QStyleOptionTab::CornerWidgets QStyleOptionTab::cornerWidgets
此变量保存CornerWidget 值的 OR 组合，表示标签栏的角部件
默认值为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
该变量用于保存标签页右侧 widget 的大小。
默认值为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
该变量用于保存制表符文本
默认值为空字符串。
© 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.
