Класс QTreeView

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

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

Свойства

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

Общедоступные функции

Переопределённые общедоступные функции

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

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

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

Сигналы

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

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

Переопределенные защищенные функции

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

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

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

Дополнительные унаследованные члены

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

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

Класс 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() с индексом модели соответствующего элемента.

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

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

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

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

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

Дерево вида Windows Vista.	Дерево вида Macintosh.	Дерево вида Fusion.

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

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

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

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

QTreeView::QTreeView(QWidget *parent = Q_NULLPTR)

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

См. также QAbstractItemModel.

QTreeView::~QTreeView()

Уничтожает представление дерева.

Сворачиваниеvoid QTreeView::collapse(const QModelIndex &index)

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

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

Свернуть все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().

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

Переопределяет QAbstractItemView::currentChanged().

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

Переопределяет QAbstractItemView::dataChanged().

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

Переопределяет QWidget::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().

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

Переопределяет QAbstractItemView::horizontalOffset().

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

Обратите внимание, что представление дерева использует позиции горизонтального заголовка для определения позиций колонок в представлении.

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

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

Возвращает индекс модели элемента, расположенного над index.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[virtual] void QTreeView::selectAll()

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

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

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

[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 устанавливается в состояние, занимающее все столбцы; в противном случае, все элементы строки отображаются.

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

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

void QTreeView::setHeader(QHeaderView *header)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

int QTreeView::treePosition() const

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

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

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

[virtual protected] void QTreeView::updateGeometries()

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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