Класс QTreeView

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

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

Свойства

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

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

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

• 59 общедоступных функций, унаследованных от QAbstractItemView
• 20 общедоступных функций, унаследованных от QAbstractScrollArea
• 14 общедоступных функций, унаследованных от QFrame
• 214 общедоступных функций, унаследованных от QWidget
• 32 общедоступных функций, унаследованных от 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 поддерживает набор сочетаний клавиш, которые позволяют пользователю перемещаться по представлению и взаимодействовать с содержимым элементов:

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

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

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

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

QTreeView::QTreeView(QWidget *parent = Q_NULLPTR)

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

См. также QAbstractItemModel.

QTreeView::~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().

[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 скрывается; в противном случае столбец 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().

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

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