QHeaderView Class

成员函数文档

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

返回标题的水平偏移量。对于垂直标题，该值为 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 （以像素为单位）。size参数的值必须大于或等于零。但不建议将size设为零。在这种情况下，应改用hideSection 。

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

[protected slot] void QHeaderView::resizeSections()

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

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        headerView, qOverload<>(&QHeaderView::resizeSections));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        headerView, [receiver = headerView]() { receiver->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 属性为true）进行测量。对于水平标题，测量沿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 处该部分的起始位置。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 为真，则由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)

将由给定的logicalIndex 指定的部分的排序指示符设置为order 指定的方向，并从其他显示该排序指示符的部分中移除该指示符。

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() const。

返回该头文件的合适大小提示。

另请参阅 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

返回设置为“拉伸”调整大小模式的区域数量。在视图中，这可用于判断当视图的几何形状发生变化时，headerview 是否需要调整这些区域的大小。

另请参阅 stretchLastSection 。

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

将视觉索引为first 的部分与视觉索引为second 的部分互换。

另请参阅 moveSection()。

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

重新实现了：QAbstractItemView::verticalOffset() const。

返回标题的垂直偏移量。对于水平标题，该值为 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()。