Класс QTableView

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

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

Свойства

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

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

Открытые слоты

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

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

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

Класс QTableView реализует представление таблицы, отображающей элементы из модели. Этот класс используется для предоставления стандартных таблиц, которые ранее предоставлялись классом QTable, но с использованием более гибкого подхода, предоставляемого архитектурой моделей/представлений Qt.

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

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

Навигация

Вы можете перемещаться по ячейкам таблицы, нажав на ячейку мышкой или используя клавиши со стрелками. Поскольку QTableView по умолчанию включает навигацию по клавише Tab, вы также можете использовать Tab и Backtab для перемещения между ячейками.

Визуальный вид

Таблица имеет вертикальную заголовок, которую можно получить, используя функцию verticalHeader(), и горизонтальную заголовок, доступную через функцию horizontalHeader(). Высота каждой строки в таблице может быть найдена с помощью rowHeight(); аналогично, ширина столбцов может быть найдена с помощью columnWidth(). Поскольку оба являются обычными виджетами, вы можете скрыть любой из них, используя их функцию hide().

Строки и столбцы могут быть скрыты и показаны с помощью hideRow(), hideColumn(), showRow() и showColumn(). Их можно выбрать с помощью selectRow() и selectColumn(). Таблица отобразит сетку в зависимости от свойства showGrid.

Элементы, отображаемые в представлении таблицы, как и в других представлениях элементов, рендерингуются и редактируются с помощью стандартных делегированных объектов. Однако для некоторых задач иногда бывает полезно иметь возможность вставлять виджеты в таблицу. Виджеты устанавливаются для определенных индексов с помощью функции setIndexWidget(), а затем извлекаются с помощью функции indexWidget().

По умолчанию ячейки таблицы не расширяются, чтобы заполнить доступное пространство. Вы можете заставить ячейки заполнить доступное пространство, растягивая последнюю секцию заголовка. Доступ к соответствующему заголовку можно получить с помощью horizontalHeader() или verticalHeader() и установить свойство заголовка stretchLastSection. Чтобы распределить доступное пространство в соответствии с требованиями каждого столбца или строки, вызовите функции представления resizeColumnsToContents() или resizeRowsToContents().

Системы координат

Для некоторых специализированных форм таблиц полезно иметь возможность переводить между индексами строк и столбцов и координатами виджетов. Функция rowAt() предоставляет координату y внутри представления для указанной строки; индекс строки может быть использован для получения соответствующей координаты y с помощью rowViewportPosition(). Функции columnAt() и columnViewportPosition() предоставляют эквивалентные операции преобразования между координатами x и индексами столбцов.

См. также QTableWidget, Классы представлений, QAbstractItemModel, QAbstractItemView, Пример Chart, Пример Pixelator и Пример модели таблицы.

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

QTableView::QTableView(QWidget *parent = nullptr)

Конструирует представление таблицы с parent для представления данных.

См. также QAbstractItemModel.

[protected slot] void QTableView::columnCountChanged(int oldCount, int newCount)

Этот слот вызывается всякий раз, когда добавляются или удаляются столбцы. Предыдущее количество столбцов задается oldCount, а новое количество — newCount.

[protected slot] void QTableView::columnMoved(int column, int oldIndex, int newIndex)

Этот слот вызывается для изменения индекса данного column в представлении таблицы. Прежний индекс задается oldIndex, а новый — newIndex.

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

[protected slot] void QTableView::columnResized(int column, int oldWidth, int newWidth)

Этот слот вызывается для изменения ширины данного column. Прежняя ширина задается oldWidth, а новая — newWidth.

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

[slot] void QTableView::hideColumn(int column)

Скрыть заданный column.

См. также showColumn() и hideRow().

[slot] void QTableView::hideRow(int row)

Скрыть заданный row.

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

[slot] void QTableView::resizeColumnToContents(int column)

Изменяет размер данного column на основе размеров подсказок делегата, используемого для отображения каждого элемента в столбце.

Примечание: Только видимые столбцы будут изменены в размерах. Переопределите sizeHintForColumn(), чтобы изменить размеры скрытых столбцов.

См. также resizeColumnsToContents(), sizeHintForColumn() и QHeaderView::resizeContentsPrecision().

[slot] void QTableView::resizeColumnsToContents()

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

См. также resizeColumnToContents(), sizeHintForColumn() и QHeaderView::resizeContentsPrecision().

[slot] void QTableView::resizeRowToContents(int row)

Изменяет высоту данного row на основе размеров подсказок делегата, используемого для отображения каждого элемента в строке.

См. также resizeRowsToContents(), sizeHintForRow() и QHeaderView::resizeContentsPrecision().

[slot] void QTableView::resizeRowsToContents()

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

См. также resizeRowToContents(), sizeHintForRow() и QHeaderView::resizeContentsPrecision().

[protected slot] void QTableView::rowCountChanged(int oldCount, int newCount)

Этот слот вызывается всякий раз, когда добавляются или удаляются строки. Предыдущее количество строк задается oldCount, а новое количество — newCount.

[protected slot] void QTableView::rowMoved(int row, int oldIndex, int newIndex)

Этот слот вызывается для изменения индекса данного row в представлении таблицы. Прежний индекс задается oldIndex, а новый — newIndex.

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

[protected slot] void QTableView::rowResized(int row, int oldHeight, int newHeight)

Этот слот вызывается для изменения высоты данного row. Прежняя высота задается oldHeight, а новая — newHeight.

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

[slot] void QTableView::selectColumn(int column)

Выделяет заданный column в представлении таблицы, если текущий SelectionMode и SelectionBehavior позволяют выделять столбцы.

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

[slot] void QTableView::selectRow(int row)

Выделяет заданную row в представлении таблицы, если текущий SelectionMode и SelectionBehavior позволяют выделять строки.

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

[slot] void QTableView::showColumn(int column)

Показать заданный столбец.

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

[slot] void QTableView::showRow(int row)

Показать заданную строку.

См. также hideRow() и showColumn().

[slot] void QTableView::sortByColumn(int column, Qt::SortOrder order)

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

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

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

См. также sortingEnabled.

[virtual] QTableView::~QTableView()

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

void QTableView::clearSpans()

Удаляет все интервалы строк и столбцов в представлении таблицы.

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

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

int QTableView::columnAt(int x) const

Возвращает столбец, в котором находится заданная координата x, x, в координатах содержимого.

Примечание: Эта функция возвращает -1, если заданная координата недействительна (нет столбца).

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

int QTableView::columnSpan(int row, int column) const

Возвращает интервал столбца элемента таблицы в позиции (row, column). По умолчанию он равен 1.

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

См. также setSpan() и rowSpan().

int QTableView::columnViewportPosition(int column) const

Возвращает координату x в координатах содержимого заданного столбца.

int QTableView::columnWidth(int column) const

Возвращает ширину заданного столбца.

См. также setColumnWidth(), resizeColumnToContents() и rowHeight().

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

Переопределяет: QAbstractItemView::currentChanged(const QModelIndex &current, const QModelIndex &previous).

QHeaderView *QTableView::horizontalHeader() const

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

См. также setHorizontalHeader(), verticalHeader() и QAbstractItemModel::headerData().

[override virtual protected] int QTableView::horizontalOffset() const

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

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

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

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

[override virtual] QModelIndex QTableView::indexAt(const QPoint &pos) const

Переопределяет: QAbstractItemView::indexAt(const QPoint &point) const.

Возвращает индексную позицию элемента модели, соответствующего элементу таблицы в позиции pos в координатах содержимого.

bool QTableView::isColumnHidden(int column) const

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

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

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

Переопределяет: QAbstractItemView::isIndexHidden(const QModelIndex &index) const.

bool QTableView::isRowHidden(int row) const

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

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

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

Переопределяет: QAbstractItemView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers).

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

См. также QAbstractItemView::CursorAction.

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

Переопределяет: QAbstractScrollArea::paintEvent(QPaintEvent *event).

Рисует таблицу при получении данного события рисования event.

int QTableView::rowAt(int y) const

Возвращает строку, в которой находится заданная координата y, y, в координатах содержимого.

Примечание: Эта функция возвращает -1, если заданная координата недействительна (нет строки).

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

int QTableView::rowHeight(int row) const

Возвращает высоту заданной строки.

См. также setRowHeight(), resizeRowToContents() и columnWidth().

int QTableView::rowSpan(int row, int column) const

Возвращает интервал строки элемента таблицы в позиции (row, column). По умолчанию он равен 1.

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

См. также setSpan() и columnSpan().

int QTableView::rowViewportPosition(int row) const

Возвращает координату y в координатах содержимого заданной строки.

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

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

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

Переопределяет: QAbstractItemView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected).

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

Если hide равно true, заданный столбец будет скрыт; в противном случае он будет показан.

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

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

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

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

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

void QTableView::setHorizontalHeader(QHeaderView *header)

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

См. также horizontalHeader() и setVerticalHeader().

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

Переопределяет: QAbstractItemView::setModel(QAbstractItemModel *model).

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

Реализует: QAbstractItemView::setRootIndex(const QModelIndex &index).

void QTableView::setRowHeight(int row, int height)

Устанавливает высоту заданной строки row на значение height.

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

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

void QTableView::setRowHidden(int row, bool hide)

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

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

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

Реализует: QAbstractItemView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags).

Выделяет элементы в заданном прямоугольнике rect в соответствии с указанными флагами выбора flags.

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

Реализует: QAbstractItemView::setSelectionModel(QItemSelectionModel *selectionModel).

void QTableView::setSortingEnabled(bool enable)

Если enable имеет значение true, то включит сортировку для таблицы и немедленно вызовет sortByColumn() с текущим разделом сортировки и порядком.

Примечание: Функция-сеттер для свойства sortingEnabled.

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

void QTableView::setSpan(int row, int column, int rowSpanCount, int columnSpanCount)

Устанавливает интервал элемента таблицы в позиции (row, column) на количество строк и столбцов, указанное в (rowSpanCount, columnSpanCount).

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

См. также rowSpan() и columnSpan().

void QTableView::setVerticalHeader(QHeaderView *header)

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

См. также verticalHeader() и setHorizontalHeader().

[override virtual protected] int QTableView::sizeHintForColumn(int column) const

Реализует: QAbstractItemView::sizeHintForColumn(int column) const.

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

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

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

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

[override virtual protected] int QTableView::sizeHintForRow(int row) const

Реализует: QAbstractItemView::sizeHintForRow(int row) const.

Возвращает размер подсказки для высоты заданной строки row или -1, если нет модели.

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

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

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

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

Реализует: QAbstractItemView::timerEvent(QTimerEvent *event).

[override virtual protected] void QTableView::updateGeometries()

Реализует: QAbstractItemView::updateGeometries().

QHeaderView *QTableView::verticalHeader() const

Возвращает вертикальный заголовок представления таблицы.

См. также setVerticalHeader(), horizontalHeader() и QAbstractItemModel::headerData().

[override virtual protected] int QTableView::verticalOffset() const

Реализует: QAbstractItemView::verticalOffset() const.

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

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

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

[override virtual protected] QStyleOptionViewItem QTableView::viewOptions() const

Реализует: QAbstractItemView::viewOptions() const.

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

Реализует: QAbstractItemView::viewportSizeHint() const.