QStyleOptionHeader Class

QStyleOptionHeader 类用于描述绘制标题的参数。更多内容...

标题：	`#include <QStyleOptionHeader>`

CMake：	`find_package(Qt6 REQUIRED COMPONENTS Widgets)` `target_link_libraries(mytarget PRIVATE Qt6::Widgets)`
qmake：	`QT += widgets`
继承自：	QStyleOption
被继承者：	QStyleOptionHeaderV2

所有成员列表（包括继承的成员）

公共类型

enum	SectionPosition { Beginning, Middle, End, OnlyOneSection }
enum	SelectedPosition { NotAdjacent, NextIsSelected, PreviousIsSelected, NextAndPreviousAreSelected }
enum	SortIndicator { None, SortUp, SortDown }
enum	StyleOptionType { Type }
enum	StyleOptionVersion { Version }

公共函数

	QStyleOptionHeader()
	QStyleOptionHeader(const QStyleOptionHeader &other)
QStyleOptionHeader &	operator=(const QStyleOptionHeader &)

公共变量

QIcon	icon
Qt::Alignment	iconAlignment
Qt::Orientation	orientation
QStyleOptionHeader::SectionPosition	position
int	section
QStyleOptionHeader::SelectedPosition	selectedPosition
QStyleOptionHeader::SortIndicator	sortIndicator
QString	text
Qt::Alignment	textAlignment

详细说明

QStyleOptionHeader 包含QStyle 函数绘制项目视图的标题面板、标题排序箭头和标题标签所需的所有信息。

出于性能考虑，该类包含的成员函数较少，且可直接访问成员变量（即使用. 或-> 运算符）。这使得这些结构体的使用非常直观，同时也强调了它们仅仅是样式函数所使用的参数。

另请参阅 QStyleOption 。

成员类型文档

enum QStyleOptionHeader::SectionPosition

此枚举可让您了解该部分相对于其他部分的位置。

常量	值	描述
`QStyleOptionHeader::Beginning`	`0`	位于页眉的开头
`QStyleOptionHeader::Middle`	`1`	位于页眉中间
`QStyleOptionHeader::End`	`2`	位于页眉末尾
`QStyleOptionHeader::OnlyOneSection`	`3`	仅有一个页眉部分

另请参阅 position 。

enum QStyleOptionHeader::SelectedPosition

此枚举可让您了解该部分相对于所选部分的位置。

常量	值	描述
`QStyleOptionHeader::NotAdjacent`	`0`	与所选部分不相邻
`QStyleOptionHeader::NextIsSelected`	`1`	选中了下一个部分
`QStyleOptionHeader::PreviousIsSelected`	`2`	选中了上一个部分
`QStyleOptionHeader::NextAndPreviousAreSelected`	`3`	已选中下一节和上一节

另请参阅 selectedPosition 。

enum QStyleOptionHeader::SortIndicator

指定应绘制排序指示符的方向

常量	值	描述
`QStyleOptionHeader::None`	`0`	无需绘制排序指示符
`QStyleOptionHeader::SortUp`	`1`	绘制向上指示符
`QStyleOptionHeader::SortDown`	`2`	绘制向下指示符

另请参阅 sortIndicator 。

enum QStyleOptionHeader::StyleOptionType

该枚举用于存储样式选项类型的相关信息，并针对每个QStyleOption 子类进行了定义。

常量	常量值简体中文（大陆）	描述
`QStyleOptionHeader::Type`	`SO_Header`	提供的样式选项的类型（对于此类而言为SO_Header ）。

该类型由QStyleOption 、其子类以及qstyleoption_cast()在内部使用，以确定样式选项的类型。通常情况下，除非您想创建自己的QStyleOption 子类和自己的样式，否则无需担心这一点。

另请参阅 StyleOptionVersion 。

enum QStyleOptionHeader::StyleOptionVersion

该枚举用于存储样式选项的版本信息，并针对每个QStyleOption 子类分别定义。

常量	常量值	描述
`QStyleOptionHeader::Version`	`1`	1

QStyleOption 子类使用该版本号来实现扩展，同时保持兼容性。如果您使用qstyleoption_cast()，通常无需检查该值。

另请参阅 StyleOptionType 。

成员函数文档

QStyleOptionHeader::QStyleOptionHeader()

构建一个 QStyleOptionHeader，并将成员变量初始化为默认值。

QStyleOptionHeader::QStyleOptionHeader(const QStyleOptionHeader &other)

创建other 样式选项的副本。

`[noexcept default]` QStyleOptionHeader &QStyleOptionHeader::operator=(const QStyleOptionHeader &)

将other 复制并赋值给此QStyleOptionHeader 实例。

成员变量文档

QIcon QStyleOptionHeader::icon

该变量存储标题栏的图标

其默认值为空图标，即既没有位图也没有文件名的图标。

Qt::Alignment QStyleOptionHeader::iconAlignment

该变量存储了标题图标的对齐标志

默认值为Qt::AlignLeft 。

Qt::Orientation QStyleOptionHeader::orientation

该变量存储标题的排列方向（横向或纵向）

默认方向为Qt::Horizontal

QStyleOptionHeader::SectionPosition QStyleOptionHeader::position

该变量存储该部分相对于其他部分的位置

默认值为QStyleOptionHeader::Beginning 。

int QStyleOptionHeader::section

该变量用于记录当前正在绘制的标题栏的哪个部分

默认值为 0。

QStyleOptionHeader::SelectedPosition QStyleOptionHeader::selectedPosition

该变量存储该部分相对于所选部分的位置

默认值为QStyleOptionHeader::NotAdjacent

QStyleOptionHeader::SortIndicator QStyleOptionHeader::sortIndicator

该变量用于指定排序指示符的绘制方向

默认值为QStyleOptionHeader::None 。

QString QStyleOptionHeader::text

该变量存储标题的文本

其默认值为空字符串。

Qt::Alignment QStyleOptionHeader::textAlignment

该变量保存了页眉文本的对齐标志