---

• 博客主页：Duck Bro 博客主页
• 系列专栏：Qt 专栏
• 关注博主，后期持续更新系列文章
• 如果有错误感谢请大家批评指出，及时修改
• 感谢大家点赞👍收藏⭐评论✍

---

Qt常用控件 | 多元素控件 | Table Widget的说明及介绍

文章编号：Qt 学习笔记 / 37

---

一、 QTableWidget介绍

1. 简介

QTableWidget是Qt中的一个控件类，用于显示和编辑二维表格数据。它继承自QTableView和QWidget类，并提供了一系列方法和信号槽，用于操作表格数据和响应用户交互。

QTableWidget可以显示任意大小的表格，每个格子可以包含文本、图像和其他自定义的小部件。它支持单元格的选择、复制、粘贴、拖拽等操作，并提供了快捷键和菜单选项来方便用户的操作。

2. 核心方法

⽅法	说明
item(int row, int column)	根据行数列数获取指定的 QTableWidgetItem*
setItem(int row, int column, QTableWidget*)	根据行数列数设置表格中的元素
currentItem()	返回被选中的元素 QTableWidgetItem*
currentRow()	返回被选中元素是第几行
currentColumn()	返回被选中元素是第几列
row(QTableWidgetItem* )	获取指定 item 是第几行
column(QTableWidgetItem* )	获取指定 item 是第几列
rowCount()	获取行数
columnCount()	获取列数
insertRow(int row)	在第 row 行处插入新行
insertColumn(int column)	在第 column 列插入新列
removeRow(int row)	删除第 row 行
removeColumn(int column)	删除第 column 列
setHorizontalHeaderItem(int column, QTableWidget*)	设置指定列的表头
setVerticalHeaderItem(int row, QTableWidget*)	设置指定行的表头

3. 核心信号

信号	说明
cellClicked(int row, int column)	点击单元格时触发
cellDoubleClicked(int row, int column)	双击单元格时触发
cellEntered(int row, int column)	鼠标进入单元格时触发
currentCellChanged(int row, int column, int previousRow, int previousColumn)	选中不同单元格时触发

---

二、QTableWidgetItem介绍

1. 简介

表格中的每个单元格, 是一个 QTableWidgetItem 对象

QTableWidgetItem是一个用于创建和操作表格项目的类。它是Qt框架中的一个类，主要用于在Qt应用程序中创建和管理表格数据。

QTableWidgetItem可以用于填充表格的单元格，并在其中存储各种类型的数据，比如文本、数字、日期和图像等。它还可以设置单元格的样式和编辑属性，以及监测和响应用户的交互操作。

2. 核心方法

⽅法	说明
row()	获取当前是第几行
column()	获取当前是第几列
setText(const QString&)	设置⽂本
setTextAlignment(int)	设置⽂本对齐
setIcon(const QIcon&)	设置图标
setSelected(bool)	设置被选中
setSizeHints(const QSize&)	设置尺寸
setFont(const QFont&)	设置字体

---

三、QTableWidget的使用（代码示例）

1. 使用Table Widget创建一个增删表

1. 在界面中创建一个Table Widget，四个PuttonButton，一个LineEdit，如图所示
   

2. 编写widget.cpp，初始化表格

Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)
{
    ui->setupUi(this);

    //新增行
    ui->tableWidget->insertRow(0);
    ui->tableWidget->insertRow(1);
    ui->tableWidget->insertRow(2);

    //新增列
    ui->tableWidget->insertColumn(0);
    ui->tableWidget->insertColumn(1);
    ui->tableWidget->insertColumn(2);

    //设置列名
    ui->tableWidget->setHorizontalHeaderItem(0,new QTableWidgetItem("学号"));
    ui->tableWidget->setHorizontalHeaderItem(1,new QTableWidgetItem("姓名"));
    ui->tableWidget->setHorizontalHeaderItem(2,new QTableWidgetItem("年龄"));

    //添加表格内容
    ui->tableWidget->setItem(0,0,new QTableWidgetItem("001"));
    ui->tableWidget->setItem(0,1,new QTableWidgetItem("小明"));
    ui->tableWidget->setItem(0,2,new QTableWidgetItem("20"));

    ui->tableWidget->setItem(1,0,new QTableWidgetItem("002"));
    ui->tableWidget->setItem(1,1,new QTableWidgetItem("小李"));
    ui->tableWidget->setItem(1,2,new QTableWidgetItem("21"));

    ui->tableWidget->setItem(2,0,new QTableWidgetItem("003"));
    ui->tableWidget->setItem(2,1,new QTableWidgetItem("小红"));
    ui->tableWidget->setItem(2,2,new QTableWidgetItem("22"));
}

3. 编写生成的按钮槽函数

void Widget::on_pushButton_insertRow_clicked()
{
    //获取到当前有多少行
    int rowCount = ui->tableWidget->rowCount();
    //插入新的行
    ui->tableWidget->insertRow(rowCount);
}

void Widget::on_pushButton_deleteRow_clicked()
{
    //获取当前选中的行
    int curRow = ui->tableWidget->currentRow();
    //删除当前选中的行
    ui->tableWidget->removeRow(curRow);
}

void Widget::on_pushButton_insertColumn_clicked()
{
    //获取当前的列数
    int colCount = ui->tableWidget->columnCount();
    //插入新的列
    ui->tableWidget->insertColumn(colCount);
    //从输入框中获取列名
    const QString& text = ui->lineEdit->text();
    //设置列名
    ui->tableWidget->setHorizontalHeaderItem(colCount,new QTableWidgetItem(text));

}

void Widget::on_pushButton_deleteColumn_clicked()
{
    //获取当前选中的列
    int curCol = ui->tableWidget->currentColumn();
    //删除选中的列
    ui->tableWidget->removeColumn(curCol);
}

4. 运行代码，实现表格的增删功能
   

---