Класс QTreeView

Класс QTreeView предоставляет стандартную реализацию представления дерева модель/вид. Подробнее...

• Список всех членов, включая унаследованные
• Устаревшие члены

Свойства

• 16 свойств унаследовано от QAbstractItemView
• 3 свойства унаследовано от QAbstractScrollArea
• 6 свойств унаследовано от QFrame
• 59 свойств унаследовано от QWidget
• 1 свойство унаследовано от QObject

Публичные функции

Реализованные публичные функции

• 60 общедоступные функции, унаследованные от QAbstractItemView
• 20 общедоступные функции, унаследованные от QAbstractScrollArea
• 14 общедоступные функции, унаследованные от QFrame
• 214 общедоступные функции, унаследованные от QWidget
• 31 общедоступные функции, унаследованные от QObject
• 14 общедоступные функции, унаследованные от QPaintDevice

Общедоступные слоты

• 9 общедоступные слоты, унаследованные от QAbstractItemView
• 19 общедоступные слоты, унаследованные от QWidget
• 1 общедоступный слот, унаследованный от QObject

Сигналы

• 7 сигналов, унаследованных от QAbstractItemView
• 3 сигнала, унаследованные от QWidget
• 2 сигнала, унаследованные от QObject

Статические общедоступные члены

• 5 статических общедоступных членов, унаследованных от QWidget
• 9 статических общедоступных членов, унаследованных от QObject

Защищенные функции

Реализованные защищенные функции

• 38 защищённых функций, унаследованных от QAbstractItemView
• 20 защищённых функций, унаследованных от QAbstractScrollArea
• 4 защищённых функций, унаследованных от QFrame
• 35 защищённых функций, унаследованных от QWidget
• 9 защищённых функций, унаследованных от QObject
• 1 защищённая функция, унаследованная от QPaintDevice

Защищённые слоты

• 9 защищённых слотов, унаследованных от QAbstractItemView
• 1 защищённый слот, унаследованный от QWidget

Подробное описание

Класс QTreeView предоставляет реализацию дерева с отображением по умолчанию на основе модели.

Класс QTreeView реализует представление дерева элементов из модели. Этот класс используется для предоставления стандартных иерархических списков, которые ранее предоставлялись классом QListView, но с использованием более гибкого подхода, предоставляемого архитектурой модели/представления Qt.

Класс QTreeView является одним из классов модели/представления и входит в состав архитектуры модель/представление Qt.

Класс QTreeView реализует интерфейсы, определённые в классе QAbstractItemView, чтобы позволить ему отображать данные, предоставляемые моделями, производными от класса QAbstractItemModel.

Создание представления дерева, отображающего данные из модели, является простым процессом. В следующем примере содержимое каталога предоставляется моделью QFileSystemModel и отображается в виде дерева:

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

Архитектура модель/представление гарантирует, что содержимое представления дерева обновляется по мере изменения модели.

Элементы, имеющие дочерние элементы, могут находиться в расширенном (дочерние элементы видны) или свёрнутом (дочерние элементы скрыты) состоянии. При изменении этого состояния генерируются сигналы collapsed() или expanded() с индексом модели соответствующего элемента.

Количество отступов, используемых для обозначения уровней иерархии, контролируется свойством indentation.

Заголовки в представлениях дерева создаются с помощью класса QHeaderView и могут быть скрыты с помощью header()->hide(). Обратите внимание, что каждый заголовок настроен с установленным свойством stretchLastSection в значение true, что гарантирует, что представление не тратит ни одного выделенного места для своего заголовка. Если это значение установлено в true, то это свойство переопределит режим изменения размера, установленный для последнего раздела в заголовке.

По умолчанию все столбцы в представлении дерева могут перемещаться, за исключением первого. Чтобы отключить перемещение этих столбцов, используйте функцию QHeaderView's setSectionsMovable(). Для получения дополнительной информации о переупорядочивании разделов см. Перемещение разделов заголовка.

Сочетания клавиш

Представление QTreeView поддерживает набор сочетаний клавиш, которые позволяют пользователю перемещаться по представлению и взаимодействовать с содержимым элементов:

Улучшение производительности

Можно дать представлению подсказки о данных, с которыми оно работает, чтобы улучшить его производительность при отображении большого количества элементов. Один подход, который можно использовать для представлений, предназначенных для отображения элементов с одинаковой высотой, заключается в установке свойства uniformRowHeights в значение true.

См. также QListView, QTreeWidget, Классы представлений, QAbstractItemModel, QAbstractItemView и Пример представления каталога.

Документация функций-членов

QTreeView::QTreeView(QWidget *parent = nullptr)

Создает представление дерева с parent для представления данных модели. Используйте setModel() для установки модели.

См. также QAbstractItemModel.

[virtual] QTreeView::~QTreeView()

Удаляет представление дерева.

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

Сворачивает элемент модели, указанный с помощью index.

См. также collapsed().

[slot] void QTreeView::collapseAll()

Сворачивает все раскрытые элементы.

Данная функция была добавлена в Qt 4.2.

См. также 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().

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

Переопределено из QAbstractItemView::dataChanged().

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

Переопределено из QAbstractItemView::dragMoveEvent().

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

Отрисовывает ветви в представлении дерева в той же строке, что и элемент модели index, используя заданный painter. Ветви отрисовываются в прямоугольнике, заданном rect.

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

Отрисовывает строку в представлении дерева, содержащую элемент модели index, используя заданный painter. option управляет способом отображения элемента.

См. также setAlternatingRowColors().

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

Отрисовывает часть дерева, пересекающую заданную region, с использованием указанного painter.

Данная функция была добавлена в Qt 4.2.

См. также paintEvent().

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

Развертывает элемент модели, указанный index.

См. также expanded().

[slot] void QTreeView::expandAll()

Развертывает все разворачиваемые элементы.

Предупреждение: если модель содержит большое количество элементов, выполнение этой функции займет некоторое время.

Данная функция была добавлена в Qt 4.2.

См. также collapseAll(), expand(), collapse() и setExpanded().

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

Развертывает все разворачиваемые элементы до заданной depth.

Данная функция была добавлена в Qt 4.3.

См. также 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.

Примечание: Эту функцию следует вызывать только после инициализации модели, так как представлению необходимо знать количество столбцов, чтобы скрыть 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().

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

Возвращает true если столбец column скрыт; в противном случае возвращает false.

См. также hideColumn() и isRowHidden().

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

Возвращает true если элемент модели index развернут; в противном случае возвращает false.

См. также expand(), expanded() и setExpanded().

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

Возвращает true если элемент в первом столбце в заданной row родителя parent охватывает все столбцы; в противном случае возвращает false.

Данная функция была добавлена в Qt 4.3.

См. также setFirstColumnSpanned().

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

Переопределено из QAbstractItemView::isIndexHidden().

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

Возвращает true, если элемент в заданной строке row родительского элемента parent скрыт; в противном случае возвращает false.

См. также setRowHidden() и isColumnHidden().

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

Переопределено из QAbstractItemView::keyPressEvent().

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

Переопределено из QAbstractItemView::keyboardSearch().

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

Переопределено из QAbstractItemView::mouseDoubleClickEvent().

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

Переопределено из QAbstractItemView::mouseMoveEvent().

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

Переопределено из QAbstractItemView::mousePressEvent().

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

Переопределено из QAbstractItemView::mouseReleaseEvent().

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

Переопределено из QAbstractItemView::moveCursor().

Перемещает курсор описанным способом в cursorAction, используя информацию, предоставленную кнопкой modifiers.

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

Переопределено из QAbstractScrollArea::paintEvent().

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

Данная функция была введена в Qt 4.3.

См. также indexRowSizeHint().

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

Переопределено из QAbstractItemView::rowsAboutToBeRemoved().

Уведомляет виджет, что строки от start до end (включительно) родительского элемента модели parent собираются удалить.

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

Переопределено из QAbstractItemView::rowsInserted().

Уведомляет виджет, что строки от start до end (включительно) были вставлены в родительский элемент модели parent.

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

Уведомляет виджет, что строки от start до end (включительно) были удалены из родительского элемента модели parent.

Данная функция была введена в Qt 4.1.

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

Переопределено из QAbstractScrollArea::scrollContentsBy().

Прокручивает содержимое виджета дерева на (dx, dy).

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

Переопределено из QAbstractItemView::scrollTo().

Прокручивает содержимое дерева, пока заданный элемент модели index не станет видимым. Параметр hint более точно определяет положение элемента после операции. Если какие-либо из родителей элемента модели свёрнуты, они будут развернуты, чтобы обеспечить видимость элемента модели.

[override virtual] void QTreeView::selectAll()

Переопределено из QAbstractItemView::selectAll().

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

Переопределено из QAbstractItemView::selectedIndexes().

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

Переопределено из QAbstractItemView::selectionChanged().

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

Если hide равно true, столбец column скрывается; в противном случае – отображается.

См. также isColumnHidden(), hideColumn(), и setRowHidden().

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

Устанавливает ширину заданного столбца column в width.

Данная функция была введена в Qt 4.2.

См. также columnWidth() и resizeColumnToContents().

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

Устанавливает элемент, на который указывает index, в состояние свёрнутости или развернутости в зависимости от значения expanded.

См. также expanded(), expand(), и isExpanded().

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

Если span равно true, элемент в первом столбце строки row с данным parent устанавливается как занимающий все столбцы; в противном случае все элементы в строке row отображаются.

Данная функция была введена в Qt 4.3.

См. также isFirstColumnSpanned().

void QTreeView::setHeader(QHeaderView *header)

Устанавливает заголовок для виджета дерева в заданный header.

Виджет принимает во владение заданный header и удаляет его при установке нового заголовка.

См. также QAbstractItemModel::headerData().

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

Переопределено из QAbstractItemView::setModel().

[override virtual] void QTreeView::setRootIndex(const QModelIndex &index)

Переопределено из QAbstractItemView::setRootIndex().

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

Если hide равно true, строка row с заданным parent скрывается; в противном случае — отображается.

См. также isRowHidden() и setColumnHidden().

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

Переопределено из QAbstractItemView::setSelection().

Применяет команду выбора command к элементам внутри или касающимся прямоугольника rect.

См. также selectionCommand().

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

Переопределено из QAbstractItemView::setSelectionModel().

void QTreeView::setTreePosition(int index)

Устанавливает, что структура дерева должна быть расположена по логическому индексу index. Если установлено значение -1, дерево всегда будет следовать визуальному индексу 0.

Эта функция была добавлена в Qt 5.2.

См. также 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().

Возвращает размер подсказки для ширины столбца column или -1, если модели нет.

Если необходимо установить ширину заданного столбца в фиксированное значение, используйте QHeaderView::resizeSection() для заголовка представления.

Если вы переопределите эту функцию в подклассе, обратите внимание, что возвращаемое значение используется только при вызове resizeColumnToContents(). В этом случае, если для ширины столбца требуется большее значение, например, заголовком представления или делегатом элементов, будет использоваться это большее значение.

См. также QWidget::sizeHint, header() и QHeaderView::resizeContentsPrecision().

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

Настраивает модель для сортировки по значениям в заданном столбце column и порядке order.

column может быть -1, в этом случае индикатор сортировки не будет отображаться, и модель вернётся к своему естественному, неотсортированному порядку. Обратите внимание, что не все модели поддерживают это и даже могут аварийно завершить работу в этом случае.

Эта функция была добавлена в Qt 4.2.

См. также sortingEnabled.

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

Переопределено из QAbstractItemView::timerEvent().

int QTreeView::treePosition() const

Возвращает логический индекс, по которому установлено дерево. Если возвращаемое значение равно -1, дерево расположено по визуальному индексу 0.

Эта функция была добавлена в Qt 5.2.

См. также 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().

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

Переопределено из QAbstractItemView::viewportSizeHint().

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

Переопределено из QAbstractItemView::visualRect().

Возвращает прямоугольник на области просмотра, занимаемый элементом по индексу index. Если индекс не отображается или явно скрыт, возвращаемый прямоугольник недействителен.

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

Переопределено из QAbstractItemView::visualRegionForSelection().

Возвращает прямоугольник из области просмотра элементов в заданном selection.

Начиная с Qt 4.7, возвращаемая область содержит только прямоугольники, пересекающие (или включенные в) область просмотра.