当前位置：首页 > article >正文

QT基础十、表格组件：QTableWidget

article 2025/3/6 21:06:11

一、简介

二、主要特性

三、项目演练

1、新建一个项目，导入自己喜欢的图片

2、添加工具栏与action

3、初始化数据

函数 initTableData

函数 createRowData

4、生成action与tabelWidget槽函数

函数 on_actionInsert_triggered()

函数 on_actionDel_triggered()

函数 on_actionEdit_triggered(bool checked)

函数 on_tableWidget_itemSelectionChanged()

5、增加搜索功能

在头文件mainwindow.h添加

函数 initLineEditSearch()

函数 on_searchBtn_clicked()

在tableWidget生成一个 on_tableWidget_cellClicked(int, int)

6、运行结果

四、项目代码

1、mainwindow.h

2、mainwindow.cpp

一、简介

QTableWidget 是 Qt 框架中的一个控件，用于显示和编辑表格数据。它是基于 QTableView 的高级实现，提供了一个更简单、更直接的方式来操作表格数据，而无需深入理解底层的模型-视图架构（Model-View Architecture）。QTableWidget 内部使用了默认的 QTableWidgetItem 来存储和管理表格中的单元格数据。

二、主要特性

表格结构 ：
- 表格由行和列组成，每个单元格可以包含文本、图标或其他内容。
- 支持动态调整行数和列数。
单元格操作 ：
- 每个单元格的内容可以通过 QTableWidgetItem 进行设置和读取。
- 支持单元格的编辑、选择、排序等操作。
交互功能 ：
- 用户可以直接在单元格中输入或修改数据。
- 支持多选模式（如单选、多选、扩展选择等）。
自定义外观 ：
- 可以通过样式表（QSS）或自定义委托（Delegate）来改变表格的外观。
- 支持设置表头（水平表头和垂直表头）的文本、图标等。
信号与槽 ：
- 提供丰富的信号（如单元格点击、双击、选择变化等），方便开发者响应用户操作。

三、项目演练

1、新建一个项目，导入自己喜欢的图片

导入图片的步骤，我上一期已经演示过，这一期就不演示了，图片需要能代表头像、插入、编辑、删除。

2、添加工具栏与action

具体步骤我在上一期也演示了，文档实在是不好演示，若看上一期看不懂，建议看视频

插入与输出不用勾选Checkable，编辑因为有编辑模式和非编辑模式，所以需要勾选Checkable

最终界面样式

3、初始化数据

可以用数据库，不过我这一期不演示，以后会专门出一期数据库相关的知识

这里我们需要用到两个函数，initTableData() 是初始化整个表格数据，再将初始化一整行数据的功能封装成一个函数，可以减少代码的冗余度，因为你插入数据时也需要初始化一整行数据，到时候直接调用 createRowData() 函数就行。

函数 `initTableData`

void MainWindow::initTableData()
{
    // 定义表头内容：包括姓名、性别、出生日期、专业、是否毕业
    QStringList headList = {"姓名", "性别", "出生日期", "专业", "是否毕业"};
    
    // 设置表格的列数为表头的数量
    ui->tableWidget->setColumnCount(headList.count());

    // 遍历表头列表，设置每一列的表头项
    for (int i = 0; i < headList.size(); i++) {
        // 创建一个新的 QTableWidgetItem 对象，用于存储表头文本
        auto* item = new QTableWidgetItem(headList[i]);
        
        // 设置表头字体样式
        QFont font = item->font();
        font.setBold(true);          // 字体加粗
        font.setFamily("微软雅黑");   // 设置字体为微软雅黑
        font.setPointSize(14);       // 设置字体大小为 14
        item->setFont(font);
        
        // 设置表头文字颜色为红色
        item->setForeground(Qt::red);
        
        // 将表头项设置到表格的水平表头中
        ui->tableWidget->setHorizontalHeaderItem(i, item);
    }

    // 获取表格的水平表头对象，并设置列宽自动伸展模式
    auto* headerView = ui->tableWidget->horizontalHeader();
    headerView->setSectionResizeMode(QHeaderView::Stretch);

    // 设置第二列（性别列）为固定宽度，不随窗口调整而变化
    headerView->setSectionResizeMode(1, QHeaderView::Fixed);

    // 设置表格的行数为 100 行
    int row = 100;
    ui->tableWidget->setRowCount(row);

    // 循环生成 100 行数据
    for (int i = 0; i < row; i++) {
        maxNum++; // 员工编号递增
        
        // 随机生成员工信息
        QString name = QString::asprintf("员工%d", i + 1); // 姓名
        QString sex = (rand() % 2) ? "男" : "女";      // 性别
        QDate date(rand() % 10 + 2000, rand() % 12 + 1, rand() % 28 + 1); // 出生日期
        QStringList subjects = {"软件工程", "计算机科学与技术", "通信工程", "网络工程"}; // 专业列表
        bool graduate = (rand() % 2) ? true : false; // 是否毕业

        // 调用 createRowData 函数，将生成的数据填充到表格中
        createRowData(i, name, maxNum, sex, date,
                      subjects[rand() % subjects.size()], graduate);
    }
}

函数 `createRowData`

void MainWindow::createRowData(int index, QString name, int number, QString sex, QDate birthday, QString subject, bool graduate)
{
    // 创建一个 QList，用于存储每一行的 QTableWidgetItem 对象
    QList<QTableWidgetItem*> items;

    // 姓名列
    items.append(new QTableWidgetItem(name));
    items[0]->setData(Qt::UserRole, QVariant(number)); // 使用 UserRole 存储员工编号

    // 性别列
    items.append(new QTableWidgetItem(sex));
    QIcon icon((sex == "男") ? ":/image/boy.png" : ":/image/girl.png"); // 根据性别设置图标
    items[1]->setIcon(icon);

    // 出生日期列
    items.append(new QTableWidgetItem(birthday.toString("yyyy-MM-dd"))); // 格式化日期为字符串

    // 专业列
    items.append(new QTableWidgetItem(subject));

    // 是否毕业列
    items.append(new QTableWidgetItem(graduate ? "已毕业" : "未毕业")); 

    // 循环遍历所有列，设置单元格内容居中对齐，并将其添加到表格中
    for (int i = 0; i < items.size(); i++) {
        items[i]->setTextAlignment(Qt::AlignCenter); // 设置单元格内容居中对齐
        ui->tableWidget->setItem(index, i, items[i]); // 将单元格内容设置到表格中
    }
}