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

QT 关于QTableWidget的常规使用

news 2025/8/10 6:56:16

一、初始化

二、封装功能用法

三、结语

一、初始化

1、设置表头

直接在ui设计界面修改或者使用QT封装的函数修改，代码如下：

 QStringList recList = {"第一列", "第二列", "第三列"};
ui->tableWidget->setHorizontalHeaderLabels(recList);

2、设置行数、列数

//设置列
ui->tableWidget->setColumnCount(3);
//设置行
ui->tableWidget->setRowCount(3);

3、设置表格颜色交替

很多时候为了方便查看，相邻两行需要用到不同的颜色。代码如下，这个要同时使用QSS和封装的函数

ui->tableWidget->setAlternatingRowColors(true);//QSS表：
QTableView{background-color: rgb(250, 250, 250);alternate-background-color: rgb(232,241,250);font-size: 14pt;
}

4、设置列宽自适应

有的时候不要水平滚动条的出现，即可设置列宽自适应，所有列横向占满整个表格，看着心里舒服，代码如下：

ui->tableWidget->horizontalHeader()->setSectionResizeMode(QHeaderView::Stretch);

5、设置表格内容以及获取内容

//设置内容
int curRow = 0;//行号
int curCol= 0;//列号
ui->tableWidget->setItem(curRow, curCol, new QTableWidgetItem("这里是0列0行"));
int curRow = 1;
int curCol= 1;
ui->tableWidget->setItem(curRow, curCol, new QTableWidgetItem("这里是1列1行"));
//获取内容
QString text = ui->tableWidget->item(curRow, curCol)->text();

6、清空表格

如果需要连同单元格都清除，则调用clear()函数，如果只是想清空表格中的内容，则调用函数clearContents()，代码示例：

ui->tableWidget->clearContents();
ui->tableWidget->clear();

7、滑动表格

初始化有时需要用到，需要开始显示的不是第一行而是中间或者哪里，或者说刷新表格功能里头需要重新置顶

ui->tableWidget->verticalScrollBar()->setValue(0);//置顶
//横向horizontalScrollBar()

8、设置目标单元格为当前选中状态（单击单元格后的状态）

ui->tableWidget->setCurrentCell(row, col);

二、封装功能用法

1、遍历表格

操作表格的第一步，就是要学会遍历它，遍历代码如下，下面两个例子（2、3）便是利用遍历表格封装一些函数使用。

int rowCount = tableWidget->rowCount();//行的数量
int colCount = tableWidget->columnCount();//列的数量
for (int row = 0; row < rowCount; ++row) {for (int col= 0; row < colCount ; ++row) {QTableWidgetItem *item = tableWidget->item(row, col);if (item) {qDebug() << item->text();//打印其内容}}
}

2、修改表格目标行的颜色

有时候需要暂时改变某一行的颜色来突出显示它，也可能是其他原因需要改变一下这一行的颜色，基于遍历表格的方法封装函数代码如下，传入参数：目标函数号、表格体、颜色

void changeTableWRowColor(int curRow, QTableWidget *tableWidget, const QColor &color)
{for (int col = 0; col < tableWidget->columnCount(); ++col) {QTableWidgetItem *item = tableWidget->item(curRow, col);if (item) {item->setBackground(color);//设置背景 样例：QColor(255, 0, 0)//设置文字颜色:setForeground(QColor(255, 0, 0))}}
}

3、在某一列查找一个内容

基于遍历表格的方法，遍历时判断内容，对比内容，查到即返回行号。传入参数：表格、内容、列号。可以对函数稍作修改，变为查找表格中内容所有内容进行对比，查找目标内容有几个以及对应的坐标。在某一列查找一个内容的示例封装函数如下：

int findRowByValue(QTableWidget *tableWidget, const QString &value, int col)
{int rowCount = tableWidget->rowCount();for (int row = 0; row < rowCount; ++row) {QTableWidgetItem *item = tableWidget->item(row, col); // 获取第一列的单元格if (item && item->text() == value) {return row; // 找到匹配的值，返回行号}}return -1; // 没有找到匹配的值，返回-1
}

4、设置表格内容改变时，识别内容并作出处理

这里示例是当出现什么结果时，显示什么文字，改变槽函数示例代码如下，进入槽函数时解开信号，完成时重新绑定，以免出现回调死循环。

//表格内容显示翻译
void MainWindow::on_tableWidget_cellChanged(int row, int column)
{//进入时解除连接disconnect(ui->tableWidget, SIGNAL(cellChanged(int, int)), this, SLOT(on_tableWidget_cellChanged(int, int)));if(column == 1){//选定列号为1，即第二列QTableWidgetItem *curItem = ui->tableWidget->item(row, 1);//这里我已确保curItem 不会为空，如果你有删除操作则需要判断curItem 是否为空以免程序异常退出QString bacthSatus = curItem->text();//表格内容QString bacthSatusTip;if(bacthSatus == "11"){bacthSatusTip = "处理中...";}else if(bacthSatus == "22"){bacthSatusTip = "已完成！";}else{bacthSatusTip = QString("错误状态：%1").arg(bacthSatus);}curItem->setText(bacthSatusTip);}//完成时重新连接connect(ui->tableWidget, SIGNAL(cellChanged(int, int)), this, SLOT(on_tableWidget_cellChanged(int, int)));
}