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() 常量。

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

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

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

如果parent 中给定的row 第一列中的项目横跨所有列，则返回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()。

[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)

通知视图已从给定的parent 模型项中删除了从start 行到end 行（含 行）的记录。

[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 为真，则隐藏带有给定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() 常量。

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

另请参阅 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 的项目在视口中占据的矩形。如果索引不可见或显式隐藏，返回的矩形无效。

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

重实现：QAbstractItemView::visualRegionForSelection(const QItemSelection &selection) 常量。

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

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