QTreeView Class

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

成员函数文档

[explicit] QTreeView::QTreeView(QWidget *parent = nullptr)

构建一个带有parent 的树形视图，用于展示模型的数据。使用setModel()来设置模型。

另请参阅 QAbstractItemModel 。

[virtual noexcept] QTreeView::~QTreeView()

销毁树形视图。

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

[override virtual protected] void QTreeView::dragMoveEvent(QDragMoveEvent *event)

重写了：QAbstractItemView::dragMoveEvent(QDragMoveEvent *event)。

[virtual protected] void QTreeView::drawBranches(QPainter *painter, const QRect &rect, const QModelIndex &index) const

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

[virtual protected] void QTreeView::drawRow(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const

使用给定的painter ，在树视图中绘制包含模型项index 的行。option 控制该项的显示方式。

另请参阅 setAlternatingRowColors()。

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

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

另请参阅 paintEvent()。

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

展开由index 指定的模型项。

另请参阅 expanded()。

[slot] void QTreeView::expandAll()

展开所有可展开的项目。

另请参阅 collapseAll()、expand()、collapse() 和setExpanded()。

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

将位于指定位置（index ）的项目及其所有子项展开至指定位置（depth ）。展开位置（depth ）相对于指定位置（index ）。若展开位置（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()。

bool QTreeView::isColumnHidden(int column) const

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

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

bool QTreeView::isExpanded(const QModelIndex &index) const

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

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

bool QTreeView::isFirstColumnSpanned(int row, const QModelIndex &parent) const

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

另请参阅 setFirstColumnSpanned()。

[override virtual protected] bool QTreeView::isIndexHidden(const QModelIndex &index) const

重写了：QAbstractItemView::isIndexHidden(const QModelIndex &index) const。

bool QTreeView::isRowHidden(int row, const QModelIndex &parent) const

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

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

[since 6.12] QRect QTreeView::itemDecorationRect(const QModelIndex &index) const

返回位于index 处的项的展开/折叠指示器所占用的矩形。如果该项没有此类指示器（例如因为没有子项，或者因为禁用了根装饰），则返回的矩形无效。无效的index 也会返回一个无效的矩形。

该函数在 Qt 6.12 中引入。

另请参阅 visualRect() 和QStyle::SE_TreeViewDisclosureItem 。

[override virtual protected] void QTreeView::keyPressEvent(QKeyEvent *event)

重写了：QAbstractItemView::keyPressEvent(QKeyEvent *event)。

[override virtual] void QTreeView::keyboardSearch(const QString &search)

重写了：QAbstractItemView::keyboardSearch(const QString &search)。

[override virtual protected] void QTreeView::mouseDoubleClickEvent(QMouseEvent *event)

重写了：QAbstractItemView::mouseDoubleClickEvent(QMouseEvent *event)。

[override virtual protected] void QTreeView::mouseMoveEvent(QMouseEvent *event)

重写了：QAbstractItemView::mouseMoveEvent(QMouseEvent *event)。

[override virtual protected] void QTreeView::mousePressEvent(QMouseEvent *event)

重写了：QAbstractItemView::mousePressEvent(QMouseEvent *event)。

[override virtual protected] void QTreeView::mouseReleaseEvent(QMouseEvent *event)

重写了：QAbstractItemView::mouseReleaseEvent(QMouseEvent *event)。

[override virtual protected] QModelIndex QTreeView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers)

重写：QAbstractItemView::moveCursor （QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers）。

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

[override virtual protected] void QTreeView::paintEvent(QPaintEvent *event)

重写了：QAbstractScrollArea::paintEvent(QPaintEvent *event)。

[override virtual] void QTreeView::reset()

重写了：QAbstractItemView::reset()。

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

将传入的column 调整为与其内容大小相符的尺寸。

另请参阅 columnWidth()、setColumnWidth()、sizeHintForColumn() 以及QHeaderView::resizeContentsPrecision()。

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

返回由给定的index 指定的行的高度。

另请参阅 indexRowSizeHint()。

[override virtual protected] void QTreeView::rowsAboutToBeRemoved(const QModelIndex &parent, int start, int end)

重写：QAbstractItemView::rowsAboutToBeRemoved （const QModelIndex &parent, int start, int end）。

通知视图，从start 行到end 行（含）的行即将从给定的parent 模型项中移除。

[override virtual protected] void QTreeView::rowsInserted(const QModelIndex &parent, int start, int end)

重写：QAbstractItemView::rowsInserted （const QModelIndex &parent, int start, int end）。

通知视图，从start 行到end 行（含）的行已插入到parent 模型项中。

[protected slot] void QTreeView::rowsRemoved(const QModelIndex &parent, int start, int end)

告知视图，从start 行到end 行（含）的行已从给定的parent 模型项中删除。

[override virtual protected] void QTreeView::scrollContentsBy(int dx, int dy)

重写：QAbstractScrollArea::scrollContentsBy(int dx, int dy)。

将树视图的内容按 (dx,dy) 滚动。

[override virtual] void QTreeView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint = EnsureVisible)

重写自：QAbstractItemView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint)。

滚动树视图的内容，直到给定的模型项index 可见。hint 参数更精确地指定了该项在操作完成后应位于的位置。如果该模型项的任何父项处于折叠状态，则会将其展开，以确保该模型项可见。

[override virtual] void QTreeView::selectAll()

重写了：QAbstractItemView::selectAll()。

[override virtual protected] QModelIndexList QTreeView::selectedIndexes() const

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

[override virtual protected] void QTreeView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)

重写了：QAbstractItemView::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 为真，则在row 中，具有给定parent 的第一列项目将被设置为横跨所有列；否则，将显示row 上的所有项目。

另请参阅 isFirstColumnSpanned()。

void QTreeView::setHeader(QHeaderView *header)

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

该视图将接管指定的header ，并在设置新标题时将其删除。

另请参阅 QAbstractItemModel::headerData()。

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

重写了：QAbstractItemView::setModel(QAbstractItemModel *model)。

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

[override virtual protected] void QTreeView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags command)

重写了：QAbstractItemView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags)。

将选择操作command 应用于矩形内的项目或被该矩形触及的项目，rect 。

另请参阅 selectionCommand()。

[override virtual] void QTreeView::setSelectionModel(QItemSelectionModel *selectionModel)

重写：QAbstractItemView::setSelectionModel(QItemSelectionModel *selectionModel)。

void QTreeView::setTreePosition(int index)

这指定树结构应位于逻辑索引index 处。如果将 设置为 -1，则该树将始终位于视觉索引 0 处。

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

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

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

另请参阅 hideColumn() 和setColumnHidden()。

[override virtual protected] int QTreeView::sizeHintForColumn(int column) const

重写：QAbstractItemView::sizeHintForColumn(int column) const。

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

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

若在子类中重写此函数，请注意：您返回的值仅在调用 `resizeColumnToContents()` 时才会被使用。在这种情况下，如果视图的标题栏或项目委托方需要更大的列宽，则会优先使用该宽度。

另请参阅 QWidget::sizeHint 、header() 和QHeaderView::resizeContentsPrecision()。

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

根据给定的column 和order 中的值对模型进行排序。

column 该值可以是 -1，此时不会显示任何排序标记，模型将恢复到其自然、未排序的顺序。请注意，并非所有模型都支持此功能，甚至可能因此崩溃。

另请参阅 sortingEnabled 。

[override virtual protected] void QTreeView::timerEvent(QTimerEvent *event)

重写了：QAbstractItemView::timerEvent(QTimerEvent *event)。

int QTreeView::treePosition() const

返回树所设置的逻辑索引。如果返回值为 -1，则表示树位于视觉索引 0 处。

另请参阅 setTreePosition()。

[override virtual protected] void QTreeView::updateGeometries()

重写了：QAbstractItemView::updateGeometries()。

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

重写：QAbstractItemView::verticalOffset() const。

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

另请参阅 horizontalOffset()。

[override virtual protected] bool QTreeView::viewportEvent(QEvent *event)

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

[override virtual protected] QSize QTreeView::viewportSizeHint() const

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

[override virtual] QRect QTreeView::visualRect(const QModelIndex &index) const

重写：QAbstractItemView::visualRect(const QModelIndex &index) const。

返回在index 处该项在视口内所占的矩形区域。如果该索引不可见或被显式隐藏，则返回的矩形区域无效。

另请参阅 itemDecorationRect()。

[override virtual protected] QRegion QTreeView::visualRegionForSelection(const QItemSelection &selection) const

重写：QAbstractItemView::visualRegionForSelection(const QItemSelection &selection) const。

返回给定selection 中各项在视口内的矩形区域。

自 4.7 版本起，返回的区域仅包含与视口相交（或包含在视口内）的矩形。