QStyleOptionTab 类

QStyleOptionTab 类用于描述绘制标签栏的参数。更多...

头文件	#include <QStyleOptionTab>
CMake	find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake	QT += widgets
继承自	QStyleOption

所有成员列表，包括继承的成员

公共类型

枚举	CornerWidget { NoCornerWidgets, LeftCornerWidget, RightCornerWidget }
标志	CornerWidgets
枚举	SelectedPosition { NotAdjacent, NextIsSelected, PreviousIsSelected }
枚举	StyleOptionType { Type }
枚举	StyleOptionVersion { Version }
枚举	TabFeature { None, HasFrame }
标志	TabFeatures
枚举	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 小部件，包括 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 值的按或组合。

另请参阅 cornerWidgets。

枚举 QStyleOptionTab::SelectedPosition

此枚举描述了选中选项卡的位置。某些样式需要根据选项卡是否相邻于已选选项卡而以不同的方式绘制选项卡。

常量	值	描述
`QStyleOptionTab::NotAdjacent`	`0`	选项卡不是相邻的选项卡（或本身就是已选选项卡）。
`QStyleOptionTab::NextIsSelected`	`1`	下一个选项卡（通常是右侧的选项卡）被选中。
`QStyleOptionTab::PreviousIsSelected`	`2`	上一个选项卡（通常是左侧的选项卡）被选中。

另请参阅 selectedPosition。

枚举 QStyleOptionTab::StyleOptionType

此枚举用于保存有关样式选项类型的信息，并且为每个 QStyleOption 子类定义。

常量	值	描述
`QStyleOptionTab::Type`	`SO_Tab`	提供的样式选项的类型（对于此类，为 SO_Tab）。

类型由 QStyleOption、其子类以及 qstyleoption_cast() 内部使用，以确定样式选项的类型。通常，您无需担心此问题，除非您想创建自己的 QStyleOption 子类和自己的样式。

另请参阅 StyleOptionVersion。

枚举 QStyleOptionTab::StyleOptionVersion

此枚举用于保存有关样式选项版本的信息，并且为每个 QStyleOption 子类定义。

常量	值	描述
`QStyleOptionTab::Version`	`1`	3

版本由 QStyleOption 子类用于在不破坏兼容性的情况下实现扩展。如果您使用 qstyleoption_cast()，通常不需要检查它。

另请参阅 StyleOptionType。

枚举 QStyleOptionTab::TabFeature
标志 QStyleOptionTab::TabFeatures

描述选项卡按钮可能具有的各种功能。

常量	值	描述
`QStyleOptionTab::None`	`0x00`	正常选项卡按钮。
`QStyleOptionTab::HasFrame`	`0x01`	选项卡按钮位于选项卡框架上。

TabFeatures 类型是 QFlags<TabFeature> 的同义词。它存储 TabFeature 值的按或组合。

另请参阅 QStyleOptionToolBar::features。

枚举 QStyleOptionTab::TabPosition

此枚举描述选项卡的位置。

常量	值	描述
`QStyleOptionTab::Beginning`	`0`	标签栏中的第一个标签。
`QStyleOptionTab::Middle`	`1`	标签既不是标签栏的第一个标签也不是最后一个标签。
`QStyleOptionTab::End`	`2`	标签栏中的最后一个标签。
`QStyleOptionTab::OnlyOneTab`	`3`	标签既是标签栏的第一个标签也是最后一个标签。
`QStyleOptionTab::Moving (自 Qt 6.6 开始)`	`4`	通过鼠标拖动或动画移动标签。

另请参阅 位置。

成员函数文档

QStyleOptionTab::QStyleOptionTab()

构建一个QStyleOptionTab对象，将成员变量初始化为其默认值。

QStyleOptionTab::QStyleOptionTab(const QStyleOptionTab &other)

构建一个对other样式选项的副本。

成员变量文档

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

此变量保留选项卡的文本

默认值是一个空字符串。