QHeaderView 类

treeView->setRootIsDecorated(false);
treeView->header()->setFirstSectionMovable(true);

成员函数文档

[显式] QHeaderView::QHeaderView(Qt::Orientation orientation, QWidget *parent = nullptr)

创建一个具有给定orientation和parent的新通用表头。

[虚拟 noexcept] QHeaderView::~QHeaderView()

销毁表头。

int QHeaderView::count() const

返回表头中的部分数。

另请参阅sectionCountChanged()和length()。

[覆盖虚拟受保护的] void QHeaderView::currentChanged(const QModelIndex &current, const QModelIndex &old)

重新实现了：QAbstractItemView::currentChanged(const QModelIndex &current, const QModelIndex &previous)

[覆盖虚拟受保护的] bool QHeaderView::event(QEvent *e)

重新实现了：QAbstractItemView::event(QEvent *event)

[信号] void QHeaderView::geometriesChanged()

当表头的几何形状发生变化时发出此信号。

[槽] void QHeaderView::headerDataChanged(Qt::Orientation orientation, int logicalFirst, int logicalLast)

使用给定的orientation从logicalFirst到logicalLast（含）更新已更改的表头部分。

int QHeaderView::hiddenSectionCount() const

返回已隐藏的头部分区数量。

另请参阅 setSectionHidden() 和 isSectionHidden().

void QHeaderView::hideSection(int logicalIndex)

隐藏由 logicalIndex 指定的分区。

另请参阅 showSection()，isSectionHidden()，hiddenSectionCount ()，和 setSectionHidden().

[重载虚受保护] int QHeaderView::horizontalOffset() const

重实： QAbstractItemView::horizontalOffset() const.

返回头部的水平偏移量。对于垂直头部，此值为0。

另请参阅 offset().

[虚受保护] void QHeaderView::initStyleOption(QStyleOptionHeader *option) const

使用此 QHeaderView 的值初始化 option。当子类需要 QStyleOptionHeader 但不想自己填充所有信息时，此方法很有用。

另请参阅 QStyleOption::initFrom () 和 initStyleOptionForIndex().

[虚受保护，自 6.0 版起] void QHeaderView::initStyleOptionForIndex(QStyleOptionHeader *option, int logicalIndex) const

从指定的 logicalIndex 初始化装饰 option。此函数在调用 initStyleOption 后由 paintSection 的默认实现调用。

此功能是在 Qt 6.0 中引入的。

另请参阅 paintSection () 和 initStyleOption().

bool QHeaderView::isSectionHidden(int logicalIndex) const

如果 logicalIndex 指定的分区被显式地隐藏给用户，则返回 true；否则返回 false。

另请参阅 hideSection()，showSection()，setSectionHidden() 和 hiddenSectionCount().

int QHeaderView::length() const

返回头部沿其方向的长度。

另请参阅 sizeHint()，setSectionResizeMode() 和 offset().

int QHeaderView::logicalIndex(int visualIndex) const

返回给定 visualIndex 位置分区的逻辑索引，如果 visualIndex < 0 或 visualIndex >= QHeaderView::count，则返回 -1。

请注意，visualIndex 不受隐藏分区的影响。

另请参阅 visualIndex() 和 sectionPosition().

int QHeaderView::logicalIndexAt(int position) const

返回覆盖视图中给定position的节。

另请参阅visualIndexAt()和isSectionHidden()。

int QHeaderView::logicalIndexAt(int x, int y) const

返回给定坐标的节的逻辑索引。如果标题是水平的，则使用x，否则使用y来查找逻辑索引。

int QHeaderView::logicalIndexAt(const QPoint &pos) const

返回在pos中给定位置的节的逻辑索引。如果标题是水平的，则使用x坐标，否则使用y坐标来查找逻辑索引。

另请参阅sectionPosition()。

[覆盖虚保护] void QHeaderView::mouseDoubleClickEvent(QMouseEvent *e)

重新实现：QAbstractItemView::mouseDoubleClickEvent(QMouseEvent *event)。

[覆盖虚保护] void QHeaderView::mouseMoveEvent(QMouseEvent *e)

重新实现：QAbstractItemView::mouseMoveEvent(QMouseEvent *event)。

[覆盖虚保护] void QHeaderView::mousePressEvent(QMouseEvent *e)

重新实现：QAbstractItemView::mousePressEvent(QMouseEvent *event)。

[覆盖虚保护] void QHeaderView::mouseReleaseEvent(QMouseEvent *e)

重新实现：QAbstractItemView::mouseReleaseEvent(QMouseEvent *event)。

void QHeaderView::moveSection(int from, int to)

将视觉索引from的节移动到占用视觉索引to。

另请参阅sectionsMoved()。

int QHeaderView::offset() const

返回标题的偏移量：这是标题的最左侧（或顶部最左侧）可见像素。

另请参阅setOffset()。

Qt::Orientation QHeaderView::orientation() const

返回标题的方向。

另请参阅Qt::Orientation。

[覆盖虚保护] void QHeaderView::paintEvent(QPaintEvent *e)

重新实现：QAbstractScrollArea::paintEvent(QPaintEvent *event)。

[虚拟保护] void QHeaderView::paintSection(QPainter *painter, const QRect &rect, int logicalIndex) const

使用给定的 painter 和 rect 绘制由给定 logicalIndex 指定的节。

通常情况下，您无需调用此函数。

[重写虚拟] void QHeaderView::reset()

重新实现: QAbstractItemView::reset().

int QHeaderView::resizeContentsPrecision() const

返回 QHeaderView 在 ResizeToContents 下计算的精度。

另请参阅setResizeContentsPrecision() 和 setSectionResizeMode().

void QHeaderView::resizeSection(int logicalIndex, int size)

将指定由 logicalIndex 的节调整大小为 size（像素为单位）。大小参数必须是一个大于或等于零的值。然而，建议不要使用等于零的大小。在这种情况下，应使用 hideSection。

另请参阅sectionResized()、sectionSize() 和 hideSection().

void QHeaderView::resizeSections(QHeaderView::ResizeMode mode)

根据给定的 mode 调整节的大小，忽略当前的大小调整模式。

另请参阅sectionResized().

[保护槽] void QHeaderView::resizeSections()

根据节的尺寸提示调整节的大小。通常情况下，您无需调用此函数。

bool QHeaderView::restoreState(const QByteArray &state)

恢复此表头视图的 state。如果状态已恢复，此函数返回 true；否则返回 false。

另请参阅saveState().

QByteArray QHeaderView::saveState() const

保存此表头视图的当前状态。

要恢复已保存的状态，请将返回值传递给 restoreState。

另请参阅restoreState().

[信号] void QHeaderView::sectionClicked(int logicalIndex)

当点击一个节时发出此信号。节的逻辑索引由 logicalIndex 指定。

请注意，将也会发出 sectionPressed 信号。

另请参阅setSectionsClickable() 和 sectionPressed().

[信号] void QHeaderView::sectionCountChanged(int oldCount, int newCount)

当分区数量改变时，即分区被添加或删除时，发生此信号。原始数量由 oldCount 指定，新数量由 newCount 指定。

参见count()，length()，和 headerDataChanged()。

[信号] void QHeaderView::sectionDoubleClicked(int logicalIndex)

当某个分区被双击时，发生此信号。分区的逻辑索引由 logicalIndex 指定。

另请参阅 setSectionsClickable().

[信号] void QHeaderView::sectionEntered(int logicalIndex)

当光标移动到分区上并按下鼠标左键时，发生此信号。分区的逻辑索引由 logicalIndex 指定。

另请参阅setSectionsClickable() 和 sectionPressed().

[信号] void QHeaderView::sectionHandleDoubleClicked(int logicalIndex)

当某个分区被双击时，发生此信号。分区的逻辑索引由 logicalIndex 指定。

另请参阅 setSectionsClickable().

[信号] void QHeaderView::sectionMoved(int logicalIndex, int oldVisualIndex, int newVisualIndex)

当移动一个分区时发生此信号。分区的逻辑索引由 logicalIndex 指定，旧的索引由 oldVisualIndex 指定，新的索引位置由 newVisualIndex 指定。

参见moveSection()。

int QHeaderView::sectionPosition(int logicalIndex) const

返回特定 logicalIndex 的分区位置，如果分区是隐藏的，则返回 -1。位置是从第一个可见项目的左上角到 logicalIndex 的项目的左上角的像素数。对于水平标题，测量是在 x 轴上进行的，对于垂直标题，测量是在 y 轴上进行的。

参见sectionViewportPosition()。

[信号] void QHeaderView::sectionPressed(int logicalIndex)

当分区被按下时，发生此信号。分区的逻辑索引由 logicalIndex 指定。

另请参阅 setSectionsClickable().

QHeaderView::ResizeMode QHeaderView::sectionResizeMode(int logicalIndex) const

返回指定的 logicalIndex 的分区所应用的调整大小模式。

另请参阅：setSectionResizeMode。

[信号] void QHeaderView::sectionResized(int logicalIndex, int oldSize, int newSize)

当调整分区大小时发生此信号。分区的逻辑编号由 logicalIndex 指定，旧的大小由 oldSize 指定，新的大小由 newSize 指定。

参见resizeSection()。

int QHeaderView::sectionSize(int logicalIndex) const

获取给定 逻辑索引 的宽度（或高度，对于垂直表头）。

另请参阅length()，setSectionResizeMode()，和 defaultSectionSize。

[虚受保护] QSize QHeaderView::sectionSizeFromContents(int logicalIndex) const

返回由给定 逻辑索引 指定的节的内容的大小。

另请参阅defaultSectionSize。

int QHeaderView::sectionSizeHint(int logicalIndex) const

返回指定 逻辑索引 的节的一个适宜的大小提示。

Qt::SizeHintRole

另请参阅sizeHint，defaultSectionSize，minimumSectionSize，和 maximumSectionSize。

int QHeaderView::sectionViewportPosition(int logicalIndex) const

返回给定 逻辑索引 的节视口位置。

如果节被隐藏，返回值未定义。

另请参阅sectionPosition() 和 isSectionHidden。

[保护槽] void QHeaderView::sectionsAboutToBeRemoved(const QModelIndex &parent, int logicalFirst, int logicalLast)

当从 父级 中移除节时调用此槽。logicalFirst 和 logicalLast 表示节被移除的位置。

如果只移除了一个节，那么 logicalFirst 和 logicalLast 将相同。

bool QHeaderView::sectionsClickable() const

如果头部可点击，则返回 true；否则返回 false。可点击的头部可以设置成允许用户更改与头部相关的视图中的数据表示。

另请参阅 setSectionsClickable().

bool QHeaderView::sectionsHidden() const

如果在头部已隐藏节，则返回 true；否则返回 false；

另请参阅setSectionHidden。

[保护槽] void QHeaderView::sectionsInserted(const QModelIndex &parent, int logicalFirst, int logicalLast)

当在 父级 中插入节时调用此槽。logicalFirst 和 logicalLast 索引表示新节被插入的位置。

如果只插入了一个节，那么 logicalFirst 和 logicalLast 将相同。

bool QHeaderView::sectionsMovable() const

如果头部可以被用户移动，则返回 true；否则返回 false。

默认情况下，在QTreeView中（除了第一个之外），段落是可以移动的，而在QTableView中则不可以。

另请参阅 setSectionsMovable().

bool QHeaderView::sectionsMoved() const

如果头部的段落已移动则返回true；否则返回 false。

参见moveSection()。

[重写虚函数] void QHeaderView::setModel(QAbstractItemModel *model)

重写：QAbstractItemView::setModel(QAbstractItemModel *model).

[槽函数] void QHeaderView::setOffset(int offset)

设置头部的偏移量为offset。

另请参阅offset() 和 length()。

[槽函数] void QHeaderView::setOffsetToLastSection()

设置偏移量使最后一个段落可见。

另请参阅setOffset()，sectionPosition() 和 setOffsetToSectionPosition()。

[槽函数] void QHeaderView::setOffsetToSectionPosition(int visualSectionNumber)

将偏移量设置为给定visualSectionNumber的段起始位置。visualSectionNumber是不考虑hiddenSections时的实际可见段落。这通常不等于visualIndex。

另请参阅setOffset() 和 sectionPosition()。

void QHeaderView::setResizeContentsPrecision(int precision)

设置在使用ResizeToContents时QHeaderView应该如何计算大小的精确程度。低值将提供不太精确但快的自动调整大小，而高值将提供更精确的调整大小，但可能较慢。

precision数字指定在计算所需大小时应考虑的段数。

默认值是1000，这意味着在自动调整大小时，水平列将查看最多1000行来计算。

特殊值0表示将只查看可视线。特殊值-1将表示查看所有元素。

此值用于QTableView::sizeHintForColumn()，QTableView::sizeHintForRow() 和 QTreeView::sizeHintForColumn()。重写这些函数可以使此函数不起作用。

另请参阅resizeContentsPrecision()，setSectionResizeMode()，resizeSections()，QTableView::sizeHintForColumn()，QTableView::sizeHintForRow() 和 QTreeView::sizeHintForColumn()。

void QHeaderView::setSectionHidden(int logicalIndex, bool hide)

如果hide为 true，则根据logicalIndex指定的段落将被隐藏；否则段落将显示。

另请参阅 isSectionHidden() 和 hiddenSectionCount().

void QHeaderView::setSectionResizeMode(QHeaderView::ResizeMode mode)

将表头可以调整大小的约束设置为给定 mode 描述的大小。

另请参阅 sectionResizeMode()、length() 和 sectionResized().

void QHeaderView::setSectionResizeMode(int logicalIndex, QHeaderView::ResizeMode mode)

将指定由 logicalIndex 确定的表头中表的可以调整大小的约束设置为给定 mode 描述的大小。逻辑索引在调用此函数时应存在。

另请参阅 setStretchLastSection() 和 resizeContentsPrecision().

void QHeaderView::setSectionsClickable(bool clickable)

如果 clickable 为 true，表头将响应对单一点击的反应。

另请参阅 sectionsClickable()、sectionClicked()、sectionPressed() 和 setSortIndicatorShown().

void QHeaderView::setSectionsMovable(bool movable)

如果 movable 为 true，表头部分可以被用户移动；否则它们将固定在位置。

当与 QTreeView 一起使用时，默认情况下第一列是不可移动的（因为它包含树结构）。您可以使用 setFirstSectionMovable(true) 使其可移动。

另请参阅 sectionsMovable()、sectionMoved() 和 setFirstSectionMovable().

[重写虚保护] void QHeaderView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags)

重实现: QAbstractItemView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags).

根据指定的 flags 选择给定 rect 中的项。

基类实现不执行任何操作。

void QHeaderView::setSortIndicator(int logicalIndex, Qt::SortOrder order)

根据给定的 logicalIndex 设置指定方向的排序指示器，并从显示它的其他任何部分中移除排序指示器。

logicalIndex 可能是 -1，在这种情况下，不会显示排序指示器，模型将返回其自然顺序。注意，并非所有模型都支持此操作，并且在某些情况下可能会崩溃。

另请参阅 sortIndicatorSection() 和 sortIndicatorOrder().

[重写虚函数] void QHeaderView::setVisible(bool v)

重写用于属性的访问函数：：QWidget::visible。

void QHeaderView::showSection(int logicalIndex)

显示由 logicalIndex 指定的节。

另请参阅hideSection()，isSectionHidden()，hiddenSectionCount() 和 setSectionHidden()。

[重写虚函数] QSize QHeaderView::sizeHint() const

重写：：QAbstractScrollArea::sizeHint() const。

返回适用于此标题的适当大小提示。

另请参阅sectionSizeHint()。

[信号] void QHeaderView::sortIndicatorChanged(int logicalIndex, Qt::SortOrder order)

当包含排序指示器的节或指示顺序的顺序改变时发出此信号。节的逻辑索引由 logicalIndex 指定，排序顺序由 order 指定。

另请参阅setSortIndicator()。

Qt::SortOrder QHeaderView::sortIndicatorOrder() const

返回排序指示器的顺序。如果没有节有排序指示器，此函数的返回值是不确定的。

另请参阅setSortIndicator() 和 sortIndicatorSection()。

int QHeaderView::sortIndicatorSection() const

返回有排序指示器的节的逻辑索引。默认情况下，这是第 0 个节。

另请参阅setSortIndicator()，sortIndicatorOrder() 和 setSortIndicatorShown()。

int QHeaderView::stretchSectionCount() const

返回设置为扩展模式尺寸的节的数目。在视图中，这可以用来查看当视图的几何形状改变时头视图是否需要调整节的尺寸。

另请参阅stretchLastSection。

void QHeaderView::swapSections(int first, int second)

交换可视为 first 的节与可视为 second 的节。

参见moveSection()。

[重写虚保护函数] int QHeaderView::verticalOffset() const

重写：QAbstractItemView::verticalOffset() const。

返回标题的垂直偏移量。对于水平标题，这是 0。

另请参阅 offset().

[重写虚保护函数] bool QHeaderView::viewportEvent(QEvent *e)

重写：QAbstractItemView::viewportEvent(QEvent *event)。

int QHeaderView::visualIndex(int logicalIndex) const

返回给定 logicalIndex 指定的部分的视觉索引位置，否则返回 -1。

隐藏的部分仍有有效的视觉索引。

也请参阅logicalIndex。

int QHeaderView::visualIndexAt(int position) const

返回覆盖给定视口中 position 坐标的部分的视觉索引。

也请参阅logicalIndexAt。