QTreeView 类

    QFileSystemModel *model = new QFileSystemModel;
    model->setRootPath(QDir::currentPath());
    QTreeView *tree = new QTreeView(splitter);
    tree->setModel(model);

成员函数文档

[显式] QTreeView::QTreeView(QWidget *parent = nullptr)

使用 parent 构造树视图以表示模型的数据。使用 setModel() 设置模型。

另请参阅 QAbstractItemModel。

[虚 noexcept] QTreeView::~QTreeView()

销毁树视图。

[覆盖虚受保护] void QTreeView::changeEvent(QEvent *event)

重实现了：QFrame::changeEvent(QEvent *ev)。

[slot] void QTreeView::collapse(const QModelIndex &index)

折叠由 index 指定的模型项。

另请参阅collapsed。

[slot] void QTreeView::collapseAll()

折叠所有展开的项。

另请参阅expandAll、expand、collapse 和 setExpanded。

[signal] void QTreeView::collapsed(const QModelIndex &index)

当指定由 index 的项被折叠时，发出此信号。

int QTreeView::columnAt(int x) const

返回包含给定 x 坐标的树视图中列的列。

[protected slot] void QTreeView::columnCountChanged(int oldCount, int newCount)

通知树视图列数已从 oldCount 更改为 newCount。

[protected slot] void QTreeView::columnMoved()

每次移动列都会调用此槽函数。

[protected slot] void QTreeView::columnResized(int column, int oldSize, int newSize)

当 column 的大小在标题中更改时，将调用此函数。 oldSize 和 newSize 分别提供了像素单位的先前大小和新大小。

另请参阅setColumnWidth。

int QTreeView::columnViewportPosition(int column) const

返回 column 在视口中的水平位置。

int QTreeView::columnWidth(int column) const

返回 column 的宽度。

另请参阅resizeColumnToContents 和 setColumnWidth。

[override virtual protected] void QTreeView::currentChanged(const QModelIndex &current, const QModelIndex &previous)

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

[override virtual] void QTreeView::dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QList<int> &roles = QList<int>())

重实现了： QAbstractItemView::dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QList<int> &roles).

[覆盖虚保护] void QTreeView::dragMoveEvent(QDragMoveEvent *event)

重新实现：QAbstractItemView::dragMoveEvent(QDragMoveEvent *event).

[虚保护] void QTreeView::drawBranches(QPainter *painter, const QRect &rect, const QModelIndex &index) const

使用给定的painter，在模型项index所在的同一行中绘制树视图的分支。分支绘制在由rect指定的矩形内。

[虚保护] void QTreeView::drawRow(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const

使用给定的painter绘制包含模型项index的树视图中的行。option控制如何显示项目。

另请参阅 setAlternatingRowColors().

[保护] void QTreeView::drawTree(QPainter *painter, const QRegion &region) const

使用指定的painter绘制给定region相交的树的部分。

另请参阅 paintEvent().

[槽] void QTreeView::expand(const QModelIndex &index)

展开指定由index指定的模型项。

另请参阅 expanded().

[槽] void QTreeView::expandAll()

展开所有可展开的项目。

另请参阅 collapseAll()，expand()，collapse()和setExpanded().

[槽] void QTreeView::expandRecursively(const QModelIndex &index, int depth = -1)

展开给定index处的项及其所有子项到指定的depth。相对于给定index的depth是相对的。如果depth为-1，将展开所有子项，如果depth为0，则仅展开给定的index。

另请参阅 expandAll().

[slot] void QTreeView::expandToDepth(int depth)

将所有可展开的项目扩展到指定的 depth。

请参阅expandAll（展开全部），collapseAll（全部折叠），expand（展开），collapse（折叠）和setExpanded（设置展开状态）。

[signal] void QTreeView::expanded(const QModelIndex &index)

当 index 指定的项被展开时，此信号被发出。

请参阅setExpanded（设置展开状态）。

QHeaderView *QTreeView::header() const

返回树视图的标题。

请参阅setHeader（设置标题）和QAbstractItemModel::headerData（获取标题数据）。

[slot] void QTreeView::hideColumn(int column)

隐藏给定的 column。

请参阅showColumn（显示列）和setColumnHidden（设置列是否隐藏）。

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

重新实现：QAbstractItemView::horizontalOffset() const。

返回树视图中项目的水平偏移量。

请注意，树视图使用水平表头部分的位置来确定视图中的列的位置。

请参阅verticalOffset（垂直偏移量）。

QModelIndex QTreeView::indexAbove(const QModelIndex &index) const

返回位于 index 上方的项的模型索引。

[override virtual] QModelIndex QTreeView::indexAt(const QPoint &point) const

重新实现：QAbstractItemView::indexAt(const QPoint &point) const。

QModelIndex QTreeView::indexBelow(const QModelIndex &index) const

返回位于 index 下方的项的模型索引。

[protected] int QTreeView::indexRowSizeHint(const QModelIndex &index) const

返回由 index 指示的行的尺寸提示。

请参阅sizeHintForColumn（列尺寸提示）和uniformRowHeights（统一行高）。

布尔值 QTreeView::isColumnHidden(int column) const

如果列 column 被隐藏，则返回 true，否则返回 false。

另请参阅hideColumn() 和 isRowHidden().

布尔值 QTreeView::isExpanded(const QModelIndex &index) const

如果模型项 index 被展开，则返回 true，否则返回 false。

另请参阅expand()，expanded() 和 setExpanded().

布尔值 QTreeView::isFirstColumnSpanned(int row, const QModelIndex &parent) const

如果给定 row 的 parent 中第一列的项目跨越所有列，则返回 true，否则返回 false。

另请参阅setFirstColumnSpanned().

[重写虚拟受保护] 布尔值 QTreeView::isIndexHidden(const QModelIndex &index) const

重新实现： QAbstractItemView::isIndexHidden(const QModelIndex &index) const.

布尔值 QTreeView::isRowHidden(int row, const QModelIndex &parent) const

如果给定 parent 的 row 的项目被隐藏，则返回 true，否则返回 false。

另请参阅setRowHidden() 和 isColumnHidden().

[重写虚拟受保护] void QTreeView::keyPressEvent(QKeyEvent *event)

重新实现： QAbstractItemView::keyPressEvent(QKeyEvent *event).

[重写虚拟] void QTreeView::keyboardSearch(const QString &search)

重新实现： QAbstractItemView::keyboardSearch(const QString &search).

[重写虚拟受保护] void QTreeView::mouseDoubleClickEvent(QMouseEvent *event)

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

[重写虚拟受保护] void QTreeView::mouseMoveEvent(QMouseEvent *event)

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

[重写虚拟受保护] void QTreeView::mousePressEvent(QMouseEvent *event)

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

[覆盖虚拟保护] void QTreeView::mouseReleaseEvent(QMouseEvent *event)

重实现: QAbstractItemView::mouseReleaseEvent(QMouseEvent *event).

[覆盖虚拟保护] QModelIndex QTreeView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers)

重实现: QAbstractItemView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers).

使用按钮modifiers提供的信息，按照cursorAction描述的方式移动光标。

[覆盖虚拟保护] void QTreeView::paintEvent(QPaintEvent *event)

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

[覆盖虚拟] void QTreeView::reset()

重实现: QAbstractItemView::reset().

[槽函数] void QTreeView::resizeColumnToContents(int column)

将列column调整为其内容的大小。

另请参阅columnWidth()，setColumnWidth()，sizeHintForColumn()，以及QHeaderView::resizeContentsPrecision().

[受保护] int QTreeView::rowHeight(const QModelIndex &index) const

返回给定index指示的行的长度。

另请参阅indexRowSizeHint().

[覆盖虚拟保护] void QTreeView::rowsAboutToBeRemoved(const QModelIndex &parent, int start, int end)

重实现: QAbstractItemView::rowsAboutToBeRemoved(const QModelIndex &parent, int start, int end).

通知视图从parent模型项中即将移除始自start行至end行。

[覆盖虚拟保护] void QTreeView::rowsInserted(const QModelIndex &parent, int start, int end)

重实现: QAbstractItemView::rowsInserted(const QModelIndex &parent, int start, int end).

通知视图已将自start行至end行的行插入到parent模型项中。

[受保护槽函数] void QTreeView::rowsRemoved(const QModelIndex &parent, int start, int end)

通知视图，从起始行到结束行（含）已从给定的父项模型中删除。

[重写虚受保护] void QTreeView::scrollContentsBy(int dx, int dy)

重写:

滚动树视图的内容，移动量为(dx, dy)。

[重写虚保护] void QTreeView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint = EnsureVisible)

重写:

滚动树视图内容，直到指定的模型项index可见。参数hint更精确地指定了操作后项的位置。如果模型项的任何父项已折叠，它们将被展开以确保模型项可见。

[重写虚保护] void QTreeView::selectAll()

重写:

[重写虚保护] QModelIndexList QTreeView::selectedIndexes() const

重写:

[重写虚保护] void QTreeView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)

重写:

void QTreeView::setColumnHidden(int column, bool hide)

如果hide为真，column被隐藏，否则显示column。

另请参阅isColumnHidden()、hideColumn()和setRowHidden()。

void QTreeView::setColumnWidth(int column, int width)

将指定column的宽度设置为指定的width。

另请参阅columnWidth()和resizeColumnToContents()。

void QTreeView::setExpanded(const QModelIndex &index, bool expanded)

根据expanded的值将引用index的项设置为折叠或展开。

另请参阅expanded()、expand()和isExpanded()。

void QTreeView::setFirstColumnSpanned(int row, const QModelIndex &parent, bool span)

如果span为true，则给定parent的行中的第一列的项将被设置为跨所有列，否则将在该row上显示所有项。

另请参阅isFirstColumnSpanned。

void QTreeView::setHeader(QHeaderView *header)

将树视图的标题设置为给定的header。

视图将获取给定header的所有权，并在设置新的标题时删除它。

另请参阅QAbstractItemModel::headerData。

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

重新实现了: QAbstractItemView::setModel(QAbstractItemModel *model)。

[重写虚函数] void QTreeView::setRootIndex(const QModelIndex &index)

重新实现了: QAbstractItemView::setRootIndex(const QModelIndex &index)。

void QTreeView::setRowHidden(int row, const QModelIndex &parent, bool hide)

如果hide为true，则给定parent的row将被隐藏，否则将显示该row。

另请参阅isRowHidden和setColumnHidden。

[重写虚保护函数] void QTreeView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags command)

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

将选择command应用于矩形内的项或受矩形影响的项。

另请参阅selectionCommand。

[重写虚函数] void QTreeView::setSelectionModel(QItemSelectionModel *selectionModel)

重新实现了: QAbstractItemView::setSelectionModel(QItemSelectionModel *selectionModel)。

void QTreeView::setTreePosition(int index)

这指定树结构应放置在逻辑索引index处。如果设置为-1，则树将始终跟随可视索引0。

另请参阅treePosition()、QHeaderView::swapSections和QHeaderView::moveSection。

[槽函数] void QTreeView::showColumn(int column)

在树视图中显示给定的column。

另请参阅hideColumn和setColumnHidden。

[重载虚受保护] int QTreeView::sizeHintForColumn(int column) const

重新实现了: QAbstractItemView::sizeHintForColumn(int column) const.

返回列的宽度提示大小，如果没有模型则返回 -1。

如果您需要将给定列的宽度设置为固定值，请在视图的标题上调用 QHeaderView::resizeSection()。

如果您在子类中重新实现了此函数，请注意，您返回的值仅在使用 resizeColumnToContents() 时使用。在这种情况下，如果视图的标题或项目代理需要更大的列宽，则将使用该宽度。

另请参阅 QWidget::sizeHint，header()，以及 QHeaderView::resizeContentsPrecision。

[槽] void QTreeView::sortByColumn(int column, Qt::SortOrder order)

通过给定的 column 和 order 对模型进行排序。

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

另请参阅 sortingEnabled。

[重载虚受保护] void QTreeView::timerEvent(QTimerEvent *event)

重新实现了: QAbstractItemView::timerEvent(QTimerEvent *event)。

int QTreeView::treePosition() const

返回树设置的逻辑索引。如果返回值是 -1，则树放置在视觉索引 0。

另请参阅 setTreePosition。

[重载虚受保护] void QTreeView::updateGeometries()

重新实现了: QAbstractItemView::updateGeometries。

[重载虚受保护] int QTreeView::verticalOffset() const

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

返回树视图中项目的垂直偏移。

另请参阅 horizontalOffset。

[重载虚受保护] bool QTreeView::viewportEvent(QEvent *event)

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

[重载虚受保护] QSize QTreeView::viewportSizeHint() const

重新实现了: QAbstractItemView::viewportSizeHint() const。

[重写虚拟] QRect QTreeView::visualRect(const QModelIndex &index) const

重实现：QAbstractItemView::visualRect(const QModelIndex &index) const.

返回位于index处的项目的矩形。如果索引不可见或被显式隐藏，则返回的矩形无效。

[重写虚拟受保护] QRegion QTreeView::visualRegionForSelection(const QItemSelection &selection) const

重实现：QAbstractItemView::visualRegionForSelection(const QItemSelection &selection) const.

返回给定selection中项目在视口中的矩形。

自4.7以来，返回的区域仅包含与视口相交（或包含在视口中）的矩形。