Класс QTreeView

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

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

Свойства

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

Открытые функции

Переопределенные открытые функции

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

Публичные слоты

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

Сигналы

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

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

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

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

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

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

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

• 1 общедоступная переменная, унаследованная от QObject
• 5 статических общедоступных членов, унаследованных от QWidget
• 10 статических общедоступных членов, унаследованных от QObject
• 2 защищенные переменные, унаследованные от QObject
• 1 защищенный тип, унаследованный от QPaintDevice

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

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

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

Класс QTreeView является одним из классов модели/представления и входит в состав фреймворка Qt model/view.

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

Функция была добавлена в 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.

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