Qt开发：QTableWidget的介绍和使用

一、QTableWidget的简介

QTableWidget 是 Qt 提供的一个基于项的表格控件，继承自 QTableView。它允许开发者以行列形式展示和编辑数据，支持表头、单元格合并、样式定制等功能。与 QTableView 相比，QTableWidget 更加简单易用，适合快速开发小型表格应用。

二、QTableWidget的基本用法

1.创建表格
首先，我们需要创建一个 QTableWidget 并设置其行列数：

QTableWidget* tableWidget = new QTableWidget(5, 3); // 5行3列

2.设置表头
表头分为水平表头和垂直表头。我们可以通过以下代码设置表头标签：

QStringList headers;
headers << "姓名" << "年龄" << "城市";
tableWidget->setHorizontalHeaderLabels(headers);

3.设置和获取单元格内的小部件
void QTableWidget::setCellWidget 用于将一个小部件（widget）设置到表格的指定单元格中。通过这个函数，可以在表格的某个单元格中嵌入自定义的小部件，例如按钮、下拉框、进度条等，从而实现更复杂的交互和显示功能。
函数原型：

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

设置单元格小部件：

// 创建一个 4x4 的表格
QTableWidget tableWidget(4, 4);
tableWidget.setWindowTitle("QTableWidget Example");

// 在 (0, 0) 单元格中设置一个 QPushButton
QPushButton* button = new QPushButton("Click Me", &tableWidget);
tableWidget.setCellWidget(0, 0, button);

// 在 (1, 1) 单元格中设置一个 QComboBox
QComboBox* comboBox = new QComboBox(&tableWidget);
comboBox->addItems({
   "Option 1", "Option 2", "Option 3"});
tableWidget.setCellWidget(1, 1, comboBox);

// 在 (2, 2) 单元格中设置一个 QProgressBar
QProgressBar* progressBar = new QProgressBar(&tableWidget);
progressBar->setValue(50);
tableWidget.setCellWidget(2, 2, progressBar);

// 在 (3, 3) 单元格中设置一个 QLabel（显示图片）
QLabel* label = new QLabel(&tableWidget);
label->setPixmap(QPixmap(":/images/icon.png"));
tableWidget.setCellWidget(3, 3, label);

获取单元格小部件：

// 获取 (0, 0) 单元格中的小部件
QWidget* widget = tableWidget->cellWidget(0, 0);
if (widget) {
   
    qDebug() << "Widget found in cell (0, 0)";
    if (QPushButton* button = qobject_cast<QPushButton*>(widget)) {
   
        qDebug() << "The widget is a QPushButton with text:" << button->text();
    }
} else {
   
    qDebug() << "No widget in cell (0, 0)";
}

注意事项：

• 设置到单元格中的小部件由 QTableWidget 自动管理其生命周期。当表格被销毁时，这些小部件也会被自动销毁。
• 设置小部件会覆盖单元格的默认内容（如文本或图标）。如果需要同时显示文本和小部件，可以将小部件和文本结合使用（例如在 QLabel 中显示文本）。

4.打开和关闭持久编辑器
void QTableWidget::openPersistentEditor(QTableWidgetItem *item) 用于为指定的 QTableWidgetItem 打开一个持久编辑器（persistent editor）。持久编辑器会一直显示在单元格中，直到显式调用 closePersistentEditor 关闭它。
作用：

• 打开持久编辑器：为指定的 QTableWidgetItem 打开一个编辑器（例如 QLineEdit、QComboBox 等），并使其一直保持显示状态。
• 允许持续编辑：与普通的编辑器（通过双击单元格或调用 editItem 打开）不同，持久编辑器不会在失去焦点时自动关闭，而是会一直显示，直到显式关闭。

函数原型：

void QTableWidget::openPersistentEditor(QTableWidgetItem *item);

参数：QTableWidgetItem *item：需要打开持久编辑器的单元格项。如果 item 为 nullptr，则函数不会执行任何操作。

典型用途：

• 嵌入复杂编辑器：在单元格中嵌入复杂的编辑器，例如 QComboBox、QDateEdit 等，允许用户直接进行选择或输入。例如，在表格的某个单元格中嵌入一个下拉框，用户可以直接选择选项。
• 实现持续编辑：当需要用户持续编辑某个单元格时，可以使用持久编辑器。例如，在表格中嵌入一个 QLineEdit，用户可以随时修改内容。
• 动态控制编辑状态：在某些情况下，可能需要动态控制单元格的编辑状态。例如，根据某些条件决定是否打开持久编辑器。

示例代码：

#include <QApplication>
#include <QTableWidget>
#include <QTableWidgetItem>
#include <QPushButton>
#include <QVBoxLayout>
#include <QWidget>
#include <QComboBox>

int main(int argc, char *argv[]) {
   
    QApplication app(argc, argv);

    // 创建一个窗口
    QWidget window;
    QVBoxLayout* layout = new QVBoxLayout(&window);

    // 创建一个 2x2 的表格
    QTableWidget* tableWidget = new QTableWidget(2, 2, &window);
    layout->addWidget(tableWidget);

    // 设置表格内容
    for (int row = 0; row < 2; ++row) {
   
        for (int col = 0; col < 2; ++col) {
   
            QTableWidgetItem* item = new QTableWidgetItem(QString("Item %1,%2").arg(row).arg(col));
            tableWidget->setItem(row, col, item);
        }
    }

    // 在 (0, 0) 单元格中打开持久编辑器（QLineEdit）
    QTableWidgetItem* item = tableWidget->item(0, 0);
    tableWidget->openPersistentEditor(item);

    // 在 (1, 1) 单元格中打开持久编辑器（QComboBox）
    QComboBox* comboBox = new QComboBox(tableWidget);
    comboBox->addItems({
   "Option 1", "Option 2", "Option 3"});
    tableWidget->setCellWidget(1, 1, comboBox);

    // 添加一个按钮，用于关闭持久编辑器
    QPushButton* closeEditorButton = new QPushButton("Close Editor", &window);
    layout->addWidget(closeEditorButton);

    // 连接按钮点击信号到槽函数
    QObject::connect(closeEditorButton, &QPushButton::clicked, [tableWidget, item]() {
   
        tableWidget->closePersistentEditor(item);
    });

    // 显示窗口
    window.show();

    return app.exec();
}

5.获取单元格的列索引和行索引
QTableWidget::column(const QTableWidgetItem *item) 用于获取指定 QTableWidgetItem 所在的列索引。
函数原型：

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

QTableWidget::row(const QTableWidgetItem *item) 用于获取指定 QTableWidgetItem 所在的行索引。
函数原型：

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

示例代码：

#include <QApplication>
#include <QTableWidget>
#include <QTableWidgetItem>
#include <QDebug>

int main(int argc, char *argv[]) {
   
    QApplication app(argc, argv);

    // 创建一个 3x3 的表格
    QTableWidget tableWidget(3, 3);
    tableWidget.setWindowTitle("QTableWidget Example");

    // 设置表格内容
    for (int row = 0; row < 3; ++row) {
   
        for (int col = 0; col < 3; ++col) {
   
            QTableWidgetItem* item = new QTableWidgetItem(QString("Item %1,%2").arg(row).arg(col));
            tableWidget.setItem(row, col, item);
        }
    }

    // 获取 (1, 2) 单元格的行列索引
    QTableWidgetItem* item = tableWidget.item(1, 2);
    if (item) {
   
        int row = tableWidget.row(item);    // 获取行索引
        int col = tableWidget.column(item); // 获取列索引
        qDebug() << "Item text:" << item->text();
        qDebug() << "Row:" << row << "Column:" << col;
    } else {
   
        qDebug() << "Item not found!";
    }

    // 显示表格
    tableWidget.show();

    return app.exec();
}

6.获取表格中当前的列数和行数
QTableWidget::columnCount() 用于获取表格中当前的列数。
函数原型：

int QTableWidget::columnCount() const;

int QTableWidget::rowCount() 用于获取表格中当前的行数。
函数原型

int QTableWidget::rowCount() const;

示例代码：

#include <QApplication>
#include <QTableWidget>
#include <QDebug>

int main(int argc, char *argv[]) {
   
    QApplication app(argc, argv);

    // 创建一个 3x3 的表格
    QTableWidget tableWidget(3, 3);
    tableWidget.setWindowTitle("QTableWidget Example");

    // 设置表格内容
    for (int row = 0; row < tableWidget.rowCount(); ++row) {
   
        for (int col = 0; col < tableWidget.columnCount(); ++col) {
   
            QTableWidgetItem* item = new QTableWidgetItem(QString("Item %1,%2").arg(row).arg(col