Класс QTableWidget

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

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

Свойства

• columnCount : int
• rowCount : int

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

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

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

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

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

Сигналы

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

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

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

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

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

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

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

Класс QTableWidget предоставляет представление таблицы на основе элементов с моделью по умолчанию.

Виджеты таблиц предоставляют стандартные средства отображения таблиц для приложений. Элементы в QTableWidget предоставляются классом QTableWidgetItem.

Если вам нужна таблица, использующая вашу собственную модель данных, используйте QTableView, а не этот класс.

Виджеты таблиц могут быть созданы с необходимым количеством строк и столбцов:

    tableWidget = new QTableWidget(12, 3, this);

В качестве альтернативы таблицы могут быть созданы без заданного размера и позже изменены в размерах:

    tableWidget = new QTableWidget(this);
    tableWidget->setRowCount(10);
    tableWidget->setColumnCount(5);

Элементы создаются вне таблицы (без родительского виджета) и вставляются в таблицу с помощью setItem():

    QTableWidgetItem *newItem = new QTableWidgetItem(tr("%1").arg(
        (row+1)*(column+1)));
    tableWidget->setItem(row, column, newItem);

Если вы хотите включить сортировку в виджете таблицы, сделайте это после заполнения таблицы элементами, иначе сортировка может повлиять на порядок вставки (см. setItem() для подробностей).

Таблицы могут иметь горизонтальные и вертикальные заголовки. Самый простой способ создания заголовков — передать список строк функциям setHorizontalHeaderLabels() и setVerticalHeaderLabels(). Они обеспечат простые текстовые заголовки для столбцов и строк таблицы. Более сложные заголовки могут быть созданы из существующих элементов таблицы, которые обычно создаются вне таблицы. Например, мы можем создать элемент таблицы с иконкой и выровненным текстом и использовать его в качестве заголовка для определённого столбца:

    QTableWidgetItem *cubesHeaderItem = new QTableWidgetItem(tr("Cubes"));
    cubesHeaderItem->setIcon(QIcon(QPixmap(":/Images/cubed.png")));
    cubesHeaderItem->setTextAlignment(Qt::AlignVCenter);

Количество строк в таблице можно получить с помощью rowCount(), а количество столбцов — с помощью columnCount(). Таблицу можно очистить с помощью функции clear().

См. также QTableWidgetItem, QTableView и Моделирование/Программирование с помощью моделей и представлений.

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

QTableWidget::QTableWidget(QWidget *parent = nullptr)

Создает новое представление таблицы с заданным parent.

QTableWidget::QTableWidget(int rows, int columns, QWidget *parent = nullptr)

Создает новое представление таблицы с заданными rows и columns, и с заданным parent.

[virtual] QTableWidget::~QTableWidget()

Уничтожает этот QTableWidget.

[signal] void QTableWidget::cellActivated(int row, int column)

Этот сигнал излучается, когда ячейка, заданная значениями row и column, была активирована

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

[signal] void QTableWidget::cellChanged(int row, int column)

Этот сигнал излучается всякий раз, когда данные элемента в ячейке, заданной значениями row и column, изменяются.

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

[signal] void QTableWidget::cellClicked(int row, int column)

Этот сигнал излучается всякий раз, когда ячейка в таблице нажимается. Заданные значения row и column — это нажатая ячейка.

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

[signal] void QTableWidget::cellDoubleClicked(int row, int column)

Этот сигнал излучается всякий раз, когда ячейка в таблице дважды нажимается. Заданные значения row и column — это дважды нажатая ячейка.

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

[signal] void QTableWidget::cellEntered(int row, int column)

Этот сигнал излучается, когда курсор мыши входит в ячейку. Ячейка задаётся значениями row и column.

Этот сигнал излучается только при включенном mouseTracking или при нажатии кнопки мыши при перемещении в элемент.

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

[signal] void QTableWidget::cellPressed(int row, int column)

Этот сигнал излучается всякий раз, когда ячейка в таблице нажимается. Заданные значения row и column — это нажатая ячейка.

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

QWidget *QTableWidget::cellWidget(int row, int column) const

Возвращает виджет, отображаемый в ячейке с заданными row и column.

Примечание: таблица берет на себя владение виджетом.

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

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

[slot] void QTableWidget::clear()

Удаляет все элементы в представлении. Это также удалит все выделения и заголовки. Если вы не хотите удалять заголовки, используйте QTableWidget::clearContents(). Размеры таблицы остаются прежними.

[slot] void QTableWidget::clearContents()

Удаляет все элементы, не являющиеся заголовками, из представления. Это также удалит все выделения. Размеры таблицы остаются прежними.

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

void QTableWidget::closePersistentEditor(QTableWidgetItem *item)

Закрывает постоянный редактор для item.

См. также openPersistentEditor() и isPersistentEditorOpen().

int QTableWidget::column(const QTableWidgetItem *item) const

Возвращает номер столбца для item.

int QTableWidget::columnCount() const

Возвращает количество столбцов.

Примечание: функция-получатель для свойства columnCount.

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

[signal] void QTableWidget::currentCellChanged(int currentRow, int currentColumn, int previousRow, int previousColumn)

Этот сигнал излучается всякий раз, когда текущая ячейка изменяется. Ячейка, заданная значениями previousRow и previousColumn, — это ячейка, у которой ранее был фокус, а ячейка, заданная значениями currentRow и currentColumn, — это новая текущая ячейка.

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

int QTableWidget::currentColumn() const

Возвращает номер столбца текущего элемента.

См. также currentRow() и setCurrentCell().

QTableWidgetItem *QTableWidget::currentItem() const

Возвращает текущий элемент.

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

[signal] void QTableWidget::currentItemChanged(QTableWidgetItem *current, QTableWidgetItem *previous)

Этот сигнал излучается всякий раз, когда текущий элемент изменяется. Элемент previous — это элемент, у которого ранее был фокус, а current — это новый текущий элемент.

int QTableWidget::currentRow() const

Возвращает номер строки текущего элемента.

См. также currentColumn() и setCurrentCell().

[override virtual protected] void QTableWidget::dropEvent(QDropEvent *event)

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

[virtual protected] bool QTableWidget::dropMimeData(int row, int column, const QMimeData *data, Qt::DropAction action)

Обрабатывает data, предоставленные операцией перетаскивания и放下, которая завершилась заданным action в заданных row и column. Возвращает true если данные и действие могут быть обработаны моделью; в противном случае возвращает false.

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

void QTableWidget::editItem(QTableWidgetItem *item)

Начинает редактирование item, если оно разрешено.

[override virtual protected] bool QTableWidget::event(QEvent *e)

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

QList<QTableWidgetItem *> QTableWidget::findItems(const QString &text, Qt::MatchFlags flags) const

Находит элементы, которые соответствуют text с использованием заданных flags.

QTableWidgetItem *QTableWidget::horizontalHeaderItem(int column) const

Возвращает элемент заголовка строки для столбца column, если он задан; в противном случае возвращает 0.

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

[protected] QModelIndex QTableWidget::indexFromItem(const QTableWidgetItem *item) const

Возвращает QModelIndex, связанную с заданным элементом item.

Примечание: В версиях Qt до 5.10 эта функция принимала не-const item.

[slot] void QTableWidget::insertColumn(int column)

Вставляет пустой столбец в таблицу в позиции column.

[slot] void QTableWidget::insertRow(int row)

Вставляет пустую строку в таблицу в позиции row.

bool QTableWidget::isPersistentEditorOpen(QTableWidgetItem *item) const

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

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

См. также openPersistentEditor() и closePersistentEditor().

QTableWidgetItem *QTableWidget::item(int row, int column) const

Возвращает элемент для заданной row и column, если он задан; в противном случае возвращает 0.

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

[signal] void QTableWidget::itemActivated(QTableWidgetItem *item)

Этот сигнал излучается, когда указанный элемент item был активирован.

QTableWidgetItem *QTableWidget::itemAt(const QPoint &point) const

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

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

QTableWidgetItem *QTableWidget::itemAt(int ax, int ay) const

Возвращает элемент в позиции, эквивалентной QPoint(ax, ay) в системе координат виджета таблицы, или возвращает 0, если заданная точка не покрывается элементом в виджете таблицы.

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

[signal] void QTableWidget::itemChanged(QTableWidgetItem *item)

Этот сигнал излучается всякий раз, когда данные элемента item были изменены.

[signal] void QTableWidget::itemClicked(QTableWidgetItem *item)

Этот сигнал излучается всякий раз, когда элемент в таблице щелкается. Указанный item - это элемент, который был щелчокнут.

[signal] void QTableWidget::itemDoubleClicked(QTableWidgetItem *item)

Этот сигнал излучается всякий раз, когда элемент в таблице дважды щелкается. Указанный item - это элемент, который был дважды щелчокнут.

[signal] void QTableWidget::itemEntered(QTableWidgetItem *item)

Этот сигнал излучается, когда курсор мыши входит в элемент. Элемент item - это входящий элемент.

Этот сигнал излучается только при включённом mouseTracking или при нажатии кнопки мыши во время перемещения в элемент.

[protected] QTableWidgetItem *QTableWidget::itemFromIndex(const QModelIndex &index) const

Возвращает указатель на QTableWidgetItem, связанный с заданным index.

[signal] void QTableWidget::itemPressed(QTableWidgetItem *item)

Этот сигнал излучается всякий раз, когда элемент в таблице нажимается. Указанный item - это нажатый элемент.

const QTableWidgetItem *QTableWidget::itemPrototype() const

Возвращает шаблон элемента, используемый таблицей.

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

[signal] void QTableWidget::itemSelectionChanged()

Этот сигнал излучается всякий раз, когда изменяется выделение.

См. также selectedItems() и QTableWidgetItem::isSelected().

[protected] QList<QTableWidgetItem *> QTableWidget::items(const QMimeData *data) const

Возвращает список указателей на элементы, содержащиеся в объекте data. Если объект не был создан QTreeWidget в том же процессе, список пуст.

[virtual protected] QMimeData *QTableWidget::mimeData(const QList<QTableWidgetItem *> items) const

Возвращает объект, содержащий сериализованное описание указанных элементов items. Формат описания элементов получен из функции mimeTypes().

Если список элементов пуст, возвращается 0 вместо сериализованного пустого списка.

[virtual protected] QStringList QTableWidget::mimeTypes() const

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

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

void QTableWidget::openPersistentEditor(QTableWidgetItem *item)

Открывает редактор для данного элемента item. Редактор остаётся открытым после редактирования.

См. также closePersistentEditor() и isPersistentEditorOpen().

void QTableWidget::removeCellWidget(int row, int column)

Удаляет виджет, установленный в ячейке, указанной row и column.

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

[slot] void QTableWidget::removeColumn(int column)

Удаляет столбец column и все его элементы из таблицы.

[slot] void QTableWidget::removeRow(int row)

Удаляет строку row и все её элементы из таблицы.

int QTableWidget::row(const QTableWidgetItem *item) const

Возвращает строку для элемента item.

int QTableWidget::rowCount() const

Возвращает количество строк.

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

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

[slot] void QTableWidget::scrollToItem(const QTableWidgetItem *item, QAbstractItemView::ScrollHint hint = EnsureVisible)

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

QList<QTableWidgetItem *> QTableWidget::selectedItems() const

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

Функция возвращает список указателей на содержимое выделенных ячеек. Используйте функцию selectedIndexes() для получения полного выделения, включая пустые ячейки.

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

QList<QTableWidgetSelectionRange> QTableWidget::selectedRanges() const

Возвращает список всех выделенных диапазонов.

См. также QTableWidgetSelectionRange.

void QTableWidget::setCellWidget(int row, int column, QWidget *widget)

Устанавливает заданный виджет widget для отображения в ячейке в заданной строке и столбце, передавая владение виджетом таблице.

Если виджет ячейки A заменяется на виджет ячейки B, виджет ячейки A будет удален. Например, в приведенном ниже фрагменте кода объект QLineEdit будет удалён.

setCellWidget(row, column, new QLineEdit);
...
setCellWidget(row, column, new QTextEdit);

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

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

void QTableWidget::setColumnCount(int columns)

Устанавливает количество столбцов в модели этой таблицы на columns. Если это значение меньше, чем columnCount(), данные в ненужных столбцах удаляются.

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

См. также columnCount() и setRowCount().

void QTableWidget::setCurrentCell(int row, int column)

Устанавливает текущую ячейку в ячейку с позицией (row, column).

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

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

См. также setCurrentItem(), currentRow() и currentColumn().

void QTableWidget::setCurrentCell(int row, int column, QItemSelectionModel::SelectionFlags command)

Устанавливает текущую ячейку в ячейку с позицией (row, column), используя заданное command.

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

См. также setCurrentItem(), currentRow() и currentColumn().

void QTableWidget::setCurrentItem(QTableWidgetItem *item)

Устанавливает текущий элемент в item.

Если режим выделения не NoSelection, элемент также выделяется.

См. также currentItem() и setCurrentCell().

void QTableWidget::setCurrentItem(QTableWidgetItem *item, QItemSelectionModel::SelectionFlags command)

Устанавливает текущий элемент в item, используя заданное command.

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

См. также currentItem() и setCurrentCell().

void QTableWidget::setHorizontalHeaderItem(int column, QTableWidgetItem *item)

Устанавливает элемент горизонтальной заголовка для столбца column в item. При необходимости количество столбцов увеличивается для размещения элемента. Предыдущий элемент заголовка (если он был) удаляется.

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

void QTableWidget::setHorizontalHeaderLabels(const QStringList &labels)

Устанавливает метки горизонтальной заголовка, используя labels.

void QTableWidget::setItem(int row, int column, QTableWidgetItem *item)

Устанавливает элемент для заданной строки и столбца в item.

Таблица принимает владение элементом.

Обратите внимание, что если сортировка включена (см. sortingEnabled) и column является текущим столбцом сортировки, row будет перемещен в отсортированную позицию, определяемую item.

Если вы хотите установить несколько элементов определённой строки (например, вызвав setItem() в цикле), вы можете отключить сортировку перед этим и включить её обратно; это позволит вам использовать тот же аргумент row для всех элементов в одной строке (т.е. setItem() не будет перемещать строку).

См. также item() и takeItem().

void QTableWidget::setItemPrototype(const QTableWidgetItem *item)

Устанавливает прототип элемента для таблицы в указанный item.

Таблица виджет будет использовать функцию клонирования прототипа элемента, когда ей нужно создать новый элемент таблицы. Например, когда пользователь редактирует пустую ячейку. Это полезно, когда у вас есть подкласс QTableWidgetItem и вы хотите убедиться, что QTableWidget создаёт экземпляры вашего подкласса.

Таблица принимает владение прототипом.

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

void QTableWidget::setRangeSelected(const QTableWidgetSelectionRange &range, bool select)

Выделяет или снимает выделение с range в зависимости от select.

void QTableWidget::setRowCount(int rows)

Устанавливает количество строк в модели этой таблицы на rows. Если это значение меньше, чем rowCount(), данные в ненужных строках удаляются.

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

См. также rowCount() и setColumnCount().

void QTableWidget::setVerticalHeaderItem(int row, QTableWidgetItem *item)

Устанавливает элемент вертикального заголовка для строки row в item.

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

void QTableWidget::setVerticalHeaderLabels(const QStringList &labels)

Устанавливает метки вертикального заголовка, используя labels.

void QTableWidget::sortItems(int column, Qt::SortOrder order = Qt::AscendingOrder)

Сортирует все строки в виджете таблицы на основе column и order.

[virtual protected] Qt::DropActions QTableWidget::supportedDropActions() const

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

См. также Qt::DropActions.

QTableWidgetItem *QTableWidget::takeHorizontalHeaderItem(int column)

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

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

QTableWidgetItem *QTableWidget::takeItem(int row, int column)

Удаляет элемент в row и column из таблицы без его удаления.

QTableWidgetItem *QTableWidget::takeVerticalHeaderItem(int row)

Удаляет элемент вертикального заголовка в строке row из заголовка без его удаления.

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

QTableWidgetItem *QTableWidget::verticalHeaderItem(int row) const

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

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

int QTableWidget::visualColumn(int logicalColumn) const

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

QRect QTableWidget::visualItemRect(const QTableWidgetItem *item) const

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

int QTableWidget::visualRow(int logicalRow) const

Возвращает визуальную строку заданной logicalRow.