QHeaderView Class

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

成员函数文档

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

使用给定的orientation 和parent 创建新的通用标头。

[virtual noexcept] QHeaderView::~QHeaderView()

破坏头像。

int QHeaderView::count() const

返回页眉中的章节数量。

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

[override virtual protected] void QHeaderView::currentChanged(const QModelIndex &current, const QModelIndex &old)

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

[override virtual protected] bool QHeaderView::event(QEvent *e)

重实现：QAbstractItemView::event(QEvent *event).

[signal] void QHeaderView::geometriesChanged()

当标头的几何形状发生变化时会发出该信号。

[slot] 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() 。

[override virtual protected] int QHeaderView::horizontalOffset() const

重实现：QAbstractItemView::horizontalOffset() 常量。

返回页眉的水平偏移量。垂直标题的偏移量为 0。

另请参阅 offset().

[virtual protected] void QHeaderView::initStyleOption(QStyleOptionHeader *option) const

使用本QHeaderView 中的值初始化option 。当子类需要QStyleOptionHeader ，但又不想自己填写所有信息时，该方法非常有用。

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

[virtual protected, since 6.0] void QHeaderView::initStyleOptionForIndex(QStyleOptionHeader *option, int logicalIndex) const

从指定的logicalIndex 初始化样式option 。paintSection 的默认实现会在调用initStyleOption 后调用该函数。

该函数在 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 位置的部分的 logicalIndex，如果visualIndex < 0 或visualIndex >=QHeaderView::count() 则返回-1。

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

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

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

返回pos 中给定位置的部分的逻辑索引。如果页眉是水平的，则使用 x 坐标，否则使用 y 坐标查找逻辑索引。

另请参见 sectionPosition()。

int QHeaderView::logicalIndexAt(int position) const

返回视口中覆盖给定position 的部分。

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

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

返回位于给定坐标处的部分的逻辑索引。如果页眉是水平的，x ，否则将使用y 查找逻辑索引。

[override virtual protected] void QHeaderView::mouseDoubleClickEvent(QMouseEvent *e)

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

[override virtual protected] void QHeaderView::mouseMoveEvent(QMouseEvent *e)

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

[override virtual protected] void QHeaderView::mousePressEvent(QMouseEvent *e)

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

[override virtual protected] 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 。

[override virtual protected] void QHeaderView::paintEvent(QPaintEvent *e)

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

[virtual protected] void QHeaderView::paintSection(QPainter *painter, const QRect &rect, int logicalIndex) const

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

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

[override virtual] 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()。

[protected slot] void QHeaderView::resizeSections()

根据大小提示调整各部分的大小。通常情况下，无需调用此函数。

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

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

另请参阅 sectionResized().

bool QHeaderView::restoreState(const QByteArray &state)

恢复该标题视图的state 。如果状态已恢复，该函数返回true ；否则返回 false。

另请参见 saveState().

QByteArray QHeaderView::saveState() const

保存此标题视图的当前状态。

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

另请参阅 restoreState() 。

[signal] void QHeaderView::sectionClicked(int logicalIndex)

当点击某个部分时会发出该信号。该部分的逻辑索引由logicalIndex 指定。

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

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

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

当章节数量发生变化时，即添加或删除章节时，会发出该信号。原计数由oldCount 指定，新计数由newCount 指定。

另请参见 count()、length() 和headerDataChanged()。

[signal] void QHeaderView::sectionDoubleClicked(int logicalIndex)

双击某个部分时会发出该信号。节的逻辑索引由logicalIndex 指定。

另请参阅 setSectionsClickable() 。

[signal] void QHeaderView::sectionEntered(int logicalIndex)

当光标移动到节上并按下鼠标左键时，就会发出该信号。节的逻辑索引由logicalIndex 指定。

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

[signal] void QHeaderView::sectionHandleDoubleClicked(int logicalIndex)

双击某个部分时会发出该信号。节的逻辑索引由logicalIndex 指定。

另请参阅 setSectionsClickable() 。

[signal] 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()。

[signal] void QHeaderView::sectionPressed(int logicalIndex)

当按下某个部分时会发出该信号。节的逻辑索引由logicalIndex 指定。

另请参阅 setSectionsClickable() 。

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

返回适用于给定logicalIndex 所指定部分的调整大小模式。

另请参阅 setSectionResizeMode()。

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

该信号在调整部分大小时发出。该部分的逻辑编号由logicalIndex 指定，旧尺寸由oldSize 指定，新尺寸由newSize 指定。

另请参阅 resizeSection() 。

int QHeaderView::sectionSize(int logicalIndex) const

返回给定logicalIndex 的宽度（或垂直标题的高度）。

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

[virtual protected] QSize QHeaderView::sectionSizeFromContents(int logicalIndex) const

返回logicalIndex 指定的部分内容的大小。

另请参阅 defaultSectionSize() 。

int QHeaderView::sectionSizeHint(int logicalIndex) const

为logicalIndex 指定的部分返回合适的大小提示。

Qt::SizeHintRole

另请参阅 sizeHint(),defaultSectionSize(),minimumSectionSize() 和maximumSectionSize().

int QHeaderView::sectionViewportPosition(int logicalIndex) const

返回给定logicalIndex 的部分视口位置。

如果部分是隐藏的，则返回值未定义。

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

[protected slot] void QHeaderView::sectionsAboutToBeRemoved(const QModelIndex &parent, int logicalFirst, int logicalLast)

当parent 中的部分被删除时，会调用此槽。logicalFirst 和logicalLast 表示部分被删除的位置。

如果只删除了一个部分，logicalFirst 和logicalLast 将保持不变。

bool QHeaderView::sectionsClickable() const

返回 sectionsClickable。

另请参阅 setSectionsClickable().

bool QHeaderView::sectionsHidden() const

如果页眉中的部分已被隐藏，则返回true ；否则返回 false；

另请参见 setSectionHidden().

[protected slot] void QHeaderView::sectionsInserted(const QModelIndex &parent, int logicalFirst, int logicalLast)

在parent 中插入章节时调用此槽。logicalFirst 和logicalLast 表示新章节插入的位置。

如果只插入了一个部分，logicalFirst 和logicalLast 将是相同的。

bool QHeaderView::sectionsMovable() const

返回 sectionsMovable。

另请参阅 setSectionsMovable().

bool QHeaderView::sectionsMoved() const

如果标题中的部分已被移动，则返回true ；否则返回 false；

另请参见 moveSection().

[override virtual] void QHeaderView::setModel(QAbstractItemModel *model)

重实现：QAbstractItemView::setModel(QAbstractItemModel *model).

[slot] void QHeaderView::setOffset(int offset)

将标头偏移量设置为offset 。

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

[slot] void QHeaderView::setOffsetToLastSection()

设置偏移量，使最后一节可见。

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

[slot] void QHeaderView::setOffsetToSectionPosition(int visualSectionNumber)

在给定的visualSectionNumber 处设置偏移到部分的起始位置。当不考虑 hiddenSections 时，visualSectionNumber 是实际可见的部分。这并不总是与visualIndex() 相同。

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

void QHeaderView::setResizeContentsPrecision(int precision)

设置QHeaderView 在使用ResizeToContents 时计算大小的精确度。数值越小，自动调整大小的精度越低，但速度越快；数值越大，自动调整大小的精度越高，但速度越慢。

数字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 为真，则隐藏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)

将sectionsClickable 设置为clickable 。

另请参见 sectionsClickable().

void QHeaderView::setSectionsMovable(bool movable)

将sectionsMovable 设置为movable 。

另请参阅 sectionsMovable() 。

[override virtual protected] 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)

按order 指定的方向设置logicalIndex 指定的部分的排序指示符，并删除任何其他部分的排序指示符。

logicalIndex 可以是-1，在这种情况下，将不显示排序指示符，模型将返回其自然的、未排序的顺序。请注意，并非所有模型都支持这种排序，在这种情况下甚至可能会崩溃。

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

[override virtual] void QHeaderView::setVisible(bool v)

重构属性访问函数：QWidget::visible 。

void QHeaderView::showSection(int logicalIndex)

显示logicalIndex 指定的部分。

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

[override virtual] QSize QHeaderView::sizeHint() const

重实现：QAbstractScrollArea::sizeHint() 常量。

返回该标头的合适尺寸提示。

另请参阅 sectionSizeHint().

[signal] 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().

[override virtual protected] int QHeaderView::verticalOffset() const

重实现：QAbstractItemView::verticalOffset() 常量。

返回页眉的垂直偏移量。水平标题的偏移量为 0。

另请参阅 offset().

[override virtual protected] 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()。