QStyleOptionHeader Class
QStyleOptionHeader 类用于描述绘制页眉的参数。更多
| 页眉 | #include <QStyleOptionHeader> |
| CMake.QStyleOptionHeader | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake： | QT += widgets |
| 继承： | QStyleOption |
| 继承于： |
公共类型
| 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) |
公共变量
| 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 样式选项的副本。
成员变量文档
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
该变量用于保存页眉文本的对齐标志。
默认值为Qt::AlignLeft 。
© 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.
