表格控件QTableWidget

下面说一下表格的常用方法

行列数目、行表头、列表头

行表头：就是表格控件的第一行，用于设置每一列的标题

列表头：就是表格控件的第一列，用于设置每一行的标题，通常缺省则默认显示行号

设置和获取行列的数目

在添加n行或者n列数据之前，需要先把行设置为n或者列设置为n，开辟好空间，才能往表格里面填充数据

// 获取/设置行的数目
int rowCount() const
void setRowCount(int rows)// 获取/设置列的数目    
int columnCount() const
void setColumnCount(int columns)

插入行列

在插入一行或一列数据之前，我们要先插入一行空行或者空列来开辟空间，然后再填充数据

//在指定行号或者列号处插入一行空行或者空列
void QTableWidget::insertRow(int row)
void QTableWidget::insertColumn(int column)

删除行或列

//删除指定行或列的数据
void QTableWidget::removeRow(int row)
void QTableWidget::removeColumn(int column)

获取当前行或列（项）

获取选中行或列（项）

和当前行或列（项）有区别，只有选中了表格中的某些数据，才能获取到选中行或列（项）

//获取选中的单元格，返回1个列表，可以有多个
QList<QTableWidgetItem *> QTableWidget::selectedItems() const//获取选中的范围，QTableWidgetSelectionRange类提供方法可以获取到选中的行数，列数，开始行，结束行，开始列，结束列
QList<QTableWidgetSelectionRange> QTableWidget::selectedRanges() const

获取和设置每一个单元格项

//根据行号和列号来设置该单元格的item
void QTableWidget::setItem(int row, int column, QTableWidgetItem *item)//根据行号和列号来获取该单元格的item
QTableWidgetItem *QTableWidget::item(int row, int column) const

设置和获取行表头和列表头

// 设置行表头，参数是一个string list，可一次性设置多个列的列名
void setHorizontalHeaderLabels(const QStringList &labels)
// 获取行表头
QHeaderView *horizontalHeader() const// 设置列表头 - 通常不设置，则默认为行号
void setVerticalHeaderLabels(const QStringList &labels)
// 获取列表头
QHeaderView *verticalHeader() const

设置列宽

// 设置列的宽度 ，QHeaderView类的方法   
void QHeaderView::setSectionResizeMode(QHeaderView::ResizeMode mode)

ResizeMode是枚举，有4种取值

• QHeaderView::Interactive：用户可拖动改变列宽
• QHeaderView::Fixed：固定列宽
• QHeaderView::Stretch：拉伸自适应列宽大小
• QHeaderView::ResizeToContents：根据内容设置列宽

通常，我们将整体先设置为QHeaderView::Stretch，然后根据需要对单独的列设置

// 1、先整体设置为自适应宽度，再单独设置某一列的宽度规则
ui->twStudent->horizontalHeader()->setSectionResizeMode(QHeaderView::Stretch); // 2、然后，单独设置第一列根据内容调整宽度，
// ui->twStudent->horizontalHeader()->setSectionResizeMode(0, QHeaderView::ResizeToContents);//或者单独设置第一列为固定宽度
ui->twStudent->horizontalHeader()->setSectionResizeMode(0, QHeaderView::Fixed);
ui->twStudent->setColumnWidth(0, 80);

单元格

每个网格单元称为1个单元格。每个单元格都有1个行号和列号。

QTableWidget控件中，每一个单元格都是1个QTableWidgetItem对象，可以设置其文字内容等

获取和设置单元格

// 获取和设置指定行列位置的单元格
QTableWidgetItem *item(int row, int column) const;
void setItem(int row, int column, QTableWidgetItem *item)// 构造 QTableWidgetItem
QTableWidgetItem(const QIcon &icon, const QString &text, int type = Type)
QTableWidgetItem(const QString &text, int type = Type)

单元格对齐方式

是QTableWidgetItem类的方法

// 获取和设置单元格文本的对齐方式，是QTableWidgetItem类的方法
int textAlignment() const
void setTextAlignment(int alignment)

alignment取值

• Qt::AlignLeft 水平方向-左对齐
• Qt::AlignRight 水平方向-右对齐
• Qt::AlignHCenter 水平方向-居中对齐
• Qt::AlignTop 垂直方向-上对齐
• Qt::AlignBottom 垂直方向-下对齐
• Qt::AlignVCenter 垂直方向-居中对齐
• Qt::AlignCenter（AlignVCenter | AlignHCenter） 垂直方向和水平方向-居中对齐

单元格是否可编辑

// 获取和设置单元格是否可编辑
QAbstractItemView::EditTriggers editTriggers() const
void setEditTriggers(QAbstractItemView::EditTriggers triggers)

triggers取值

• AbstractItemView::NoEditTriggers 不可编辑
• QAbstractItemView::CurrentChanged 当切换单元格时
• QAbstractItemView::DoubleClicked 当双击单元格时
• QAbstractItemView::SelectedClicked 当单击一个已选中的单元格时
• QAbstractItemView::EditKeyPressed 当一个单元格获取焦点，按编辑按键时（F2）
• QAbstractItemView::AnyKeyPressed 当一个单元格获取焦点，按任意键时
• QAbstractItemView::AllEditTriggers 以上所有条件的组合。（31 = 1|2|4|8|16）

隔行交替背景色

即奇数行和偶数行的背景色不同，便于用户浏览

// 获取和设置是否允许隔行交替背景色（该接口Win11失效）
bool alternatingRowColors() const
void setAlternatingRowColors(bool enable)

选择行为

即单击一个单元格时，是选中该单元格，还是选中一整行，或是一整列

// 获取和设置选择行为
QAbstractItemView::SelectionBehavior selectionBehavior() const
void setSelectionBehavior(QAbstractItemView::SelectionBehavior behavior)

 behavior有3种取值

• QAbstractItemView::SelectItems 选中单元格
• QAbstractItemView::SelectRows 选中单元格所在行
• QAbstractItemView::SelectColumns 选中单元格所在列

选择模式

即表格控件只能选择单行，或者可以ctrl键或shift键一次性选择多行

// 获取和设置选择模式
QAbstractItemView::SelectionMode selectionMode() const
void setSelectionMode(QAbstractItemView::SelectionMode mode)

mode有5种取值

• QAbstractItemView::NoSelection 不可选择
• QAbstractItemView::SingleSelection 单行选择，一次只允许选择一行
• QAbstractItemView::MultiSelection 多行选择，鼠标单击就可以选择多行
• QAbstractItemView::ExtendedSelection 扩展选择，按shift键选中一个范围内的行，ctrl键可以选中不相邻的行
• QAbstractItemView::ContiguousSelection 相邻选择，按shift键或ctrl键都可以选中一个范围内的行

常用信号

//单元格被点击
[signal] void QTableWidget::itemClicked(QTableWidgetItem *item)

举例

显示当前行

 尾部添加一行

选中行前面插入一行

删除选中行

修改选中行

外观设置

选择模式设置

代码

#ifndef WIDGET_H
#define WIDGET_H#include <QWidget>
#include<QTableWidget>
#include<QHeaderView>
#include<QHBoxLayout>
#include<QVBoxLayout>
#include<QGridLayout>
#include<QGroupBox>
#include<QLineEdit>
#include<QPushButton>
#include<QLabel>
#include<QCheckBox>
#include<QRadioButton>class Widget : public QWidget
{Q_OBJECTpublic:Widget(QWidget *parent = nullptr): QWidget(parent){resize(800,500);QHBoxLayout* main_layout=new QHBoxLayout(this);/*************************初始化表格控件*******************************///创建表格，并初始化数据table=new QTableWidget(this);//设置为4列table->setColumnCount(4);//设置列宽自适应table->horizontalHeader()->setSectionResizeMode(QHeaderView::Stretch);//添加行表头table->setHorizontalHeaderLabels({"姓名","性别","年龄","籍贯"});//初始化2行数据//要先设置行数，来开辟空间table->setRowCount(2);//要先构造出列表项QTableWidgetItem* name1=new QTableWidgetItem("李雷");QTableWidgetItem* gender1=new QTableWidgetItem("男");QTableWidgetItem* age1=new QTableWidgetItem("12");QTableWidgetItem* province1=new QTableWidgetItem("广东");//设置居中对齐name1->setTextAlignment(Qt::AlignCenter);gender1->setTextAlignment(Qt::AlignCenter);age1->setTextAlignment(Qt::AlignCenter);province1->setTextAlignment(Qt::AlignCenter);//然后填充单元格数据table->setItem(0,0,name1);table->setItem(0,1,gender1);table->setItem(0,2,age1);table->setItem(0,3,province1);/********************************************************/QTableWidgetItem* name2=new QTableWidgetItem("韩梅梅");QTableWidgetItem* gender2=new QTableWidgetItem("女");QTableWidgetItem* age2=new QTableWidgetItem("11");QTableWidgetItem* province2=new QTableWidgetItem("北京");name2->setTextAlignment(Qt::AlignCenter);gender2->setTextAlignment(Qt::AlignCenter);age2->setTextAlignment(Qt::AlignCenter);province2->setTextAlignment(Qt::AlignCenter);table->setItem(1,0,name2);table->setItem(1,1,gender2);table->setItem(1,2,age2);table->setItem(1,3,province2);main_layout->addWidget(table);//初始化右边QWidget* right=new QWidget(this);main_layout->addWidget(right);right->setFixedWidth(300);QVBoxLayout* right_layout=new QVBoxLayout(right);//数据操作部分QGroupBox* group_box=new QGroupBox(this);group_box->setTitle("数据操作");right_layout->addWidget(group_box);QGridLayout* group_box_layout=new QGridLayout(group_box);name=new QLabel("姓名",this);name_edit=new QLineEdit(this);add=new QPushButton("添加一行",this);group_box_layout->addWidget(name,0,0);group_box_layout->addWidget(name_edit,0,1);group_box_layout->addWidget(add,0,2);gender=new QLabel("性别",this);gender_edit=new QLineEdit(this);insert=new QPushButton("插入一行",this);group_box_layout->addWidget(gender,1,0);group_box_layout->addWidget(gender_edit,1,1);group_box_layout->addWidget(insert,1,2);age=new QLabel("年龄",this);age_edit=new QLineEdit(this);del=new QPushButton("删除选中行",this);group_box_layout->addWidget(age,2,0);group_box_layout->addWidget(age_edit,2,1);group_box_layout->addWidget(del,2,2);province=new QLabel("籍贯",this);province_edit=new QLineEdit(this);mod=new QPushButton("修改选中行",this);group_box_layout->addWidget(province,3,0);group_box_layout->addWidget(province_edit,3,1);group_box_layout->addWidget(mod,3,2);group_box_layout->setVerticalSpacing(20);QHBoxLayout* layout_1=new QHBoxLayout();right_layout->addLayout(layout_1);QGroupBox* outlooking_setting=new QGroupBox(this);outlooking_setting->setTitle("外观设置");QVBoxLayout* layout_2=new QVBoxLayout(outlooking_setting);layout_1->addWidget(outlooking_setting);QCheckBox* row_head=new QCheckBox("行表头",this);QCheckBox* col_head=new QCheckBox("列表头",this);QCheckBox* alter_back_color=new QCheckBox("交替背景色",this);QCheckBox* editable=new QCheckBox("单元格可编辑",this);QCheckBox* style_sheet=new QCheckBox("设置样式表",this);layout_2->addWidget(row_head);layout_2->addWidget(col_head);layout_2->addWidget(alter_back_color);layout_2->addWidget(editable);layout_2->addWidget(style_sheet);//初始化复选框的选中状态row_head->setChecked(table->horizontalHeader()->isHidden()?false:true);col_head->setChecked(table->verticalHeader()->isHidden()?false:true);alter_back_color->setChecked(table->alternatingRowColors()?true:false);//如果为NoEditTriggers则表示单元格不可编辑editable->setChecked(table->editTriggers()==QAbstractItemView::NoEditTriggers?false:true);QGroupBox* select_setting=new QGroupBox(this);select_setting->setTitle("选择设置");layout_1->addWidget(select_setting);QVBoxLayout* layout_3=new QVBoxLayout(select_setting);QRadioButton* select_single=new QRadioButton("选择单元格",this);QRadioButton* select_one_row=new QRadioButton("选择行",this);layout_3->addWidget(select_single);layout_3->addWidget(select_one_row);//初始化单选按钮的选中状态int select_mode=table->selectionBehavior();if(select_mode==QAbstractItemView::SelectItems){select_single->setChecked(true);}else if(select_mode==QAbstractItemView::SelectRows){select_one_row->setChecked(true);}//将当前选中的行显示到编辑框中//绑定QTableWidget的itemClicked信号connect(table,&QTableWidget::itemClicked,this,[=](QTableWidgetItem* item){//获取到当前选中的行,下面两种方法都可//int cur_row=table->currentRow();int cur_row=item->row();//获取当前行中每一个itemname_edit->setText(table->item(cur_row,0)->text());gender_edit->setText(table->item(cur_row,1)->text());age_edit->setText(table->item(cur_row,2)->text());province_edit->setText(table->item(cur_row,3)->text());});//尾部添加一行connect(add,&QPushButton::clicked,this,[=](){//在添加之前，我们要先获取行数，把行数+1，开辟空间//如果添加n行，那么要先把行数+nint row=table->rowCount();table->setRowCount(row+1);QTableWidgetItem* name_item=new QTableWidgetItem(name_edit->text());QTableWidgetItem* gender_item=new QTableWidgetItem(gender_edit->text());QTableWidgetItem* age_item=new QTableWidgetItem(age_edit->text());QTableWidgetItem* province_item=new QTableWidgetItem(province_edit->text());//设置居中对齐name_item->setTextAlignment(Qt::AlignCenter);gender_item->setTextAlignment(Qt::AlignCenter);age_item->setTextAlignment(Qt::AlignCenter);province_item->setTextAlignment(Qt::AlignCenter);//行数的索引是从0开始的，所以新增行的索引就是row//填充单元格数据table->setItem(row,0,name_item);table->setItem(row,1,gender_item);table->setItem(row,2,age_item);table->setItem(row,3,province_item);});//当前行之前插入一行connect(insert,&QPushButton::clicked,this,[=](){//获取所有选中项auto select_items=table->selectedItems();if(select_items.empty()){//为空，证明没有选中return;}//只获取第一个选中项的行号int cur_row=select_items[0]->row();//在选中项前插入一行table->insertRow(cur_row);QTableWidgetItem* name_item=new QTableWidgetItem(name_edit->text());QTableWidgetItem* gender_item=new QTableWidgetItem(gender_edit->text());QTableWidgetItem* age_item=new QTableWidgetItem(age_edit->text());QTableWidgetItem* province_item=new QTableWidgetItem(province_edit->text());//设置居中对齐name_item->setTextAlignment(Qt::AlignCenter);gender_item->setTextAlignment(Qt::AlignCenter);age_item->setTextAlignment(Qt::AlignCenter);province_item->setTextAlignment(Qt::AlignCenter);//填充单元格数据table->setItem(cur_row,0,name_item);table->setItem(cur_row,1,gender_item);table->setItem(cur_row,2,age_item);table->setItem(cur_row,3,province_item);});//删除选中行connect(del,&QPushButton::clicked,this,[=](){//获取所有选中项auto select_items=table->selectedItems();if(select_items.empty()){//为空，证明没有选中return;}//只获取第一个选中项的行号int cur_row=select_items[0]->row();//删除选中行table->removeRow(cur_row);});//修改选中行connect(mod,&QPushButton::clicked,this,[=](){//获取所有选中项auto select_items=table->selectedItems();if(select_items.empty()){//为空，证明没有选中return;}//只获取第一个选中项的行号int cur_row=select_items[0]->row();//修改单元格数据table->item(cur_row,0)->setText(name_edit->text());table->item(cur_row,1)->setText(gender_edit->text());table->item(cur_row,2)->setText(age_edit->text());table->item(cur_row,3)->setText(province_edit->text());});//是否显示行表头connect(row_head,&QCheckBox::clicked,this,[=](){if(row_head->isChecked()){//选中后显示行表头table->horizontalHeader()->show();}else{//未选中则隐藏行表头table->horizontalHeader()->hide();}});//是否显示列表头connect(col_head,&QCheckBox::clicked,this,[=](){if(col_head->isChecked()){table->verticalHeader()->show();}else{table->verticalHeader()->hide();}});//是否交替切换行背景色connect(alter_back_color,&QCheckBox::clicked,this,[=](){if(alter_back_color->isChecked()){//win11该接口失效table->setAlternatingRowColors(true);}else{table->setAlternatingRowColors(false);}});//单元格是否可编辑connect(editable,&QCheckBox::clicked,this,[=](){if(editable->isChecked()){//双击、选中后单击、选中后按F2键都可编辑单元格table->setEditTriggers(QAbstractItemView::DoubleClicked |QAbstractItemView::SelectedClicked |QAbstractItemView::EditKeyPressed);}else{table->setEditTriggers(QAbstractItemView::NoEditTriggers);}});//设置样式表connect(style_sheet,&QCheckBox::clicked,this,[=](){if(style_sheet->isChecked()){//单元格的样式QString cellStyle = R"(QTableView{text-align:center;background-color: rgba(255, 255, 255, 0);alternate-background-color:#e3edf9;font:14px "微软雅黑";color:#677483;gridline-color: #ccddf0;})";//行表头的样式const QString horizontalHeaderStyle = R"(QHeaderView::section {color: black;font:bold 14px "微软雅黑";text-align:center;height:32px;background-color: #d1dff0;border:1px solid #8faac9;border-left:none;})";//列表头的样式const QString verticalHeaderStyle = R"(QHeaderView::section {color: black;font:bold 14px "微软雅黑";width:60px;text-align:center;background-color: #d1dff0;border:1px solid #8faac9;border-left:none;})";table->setStyleSheet(cellStyle);table->horizontalHeader()->setStyleSheet(horizontalHeaderStyle);table->verticalHeader()->setStyleSheet(verticalHeaderStyle);}else{table->setStyleSheet("");table->horizontalHeader()->setStyleSheet("");table->verticalHeader()->setStyleSheet("");}});//设置鼠标点击时只选中单元格connect(select_single,&QRadioButton::clicked,this,[=](){if(select_single->isChecked()){table->setSelectionBehavior(QAbstractItemView::SelectItems);}});//设置鼠标点击时选中一整行connect(select_one_row,&QRadioButton::clicked,this,[=](){if(select_one_row->isChecked()){table->setSelectionBehavior(QAbstractItemView::SelectRows);}});}~Widget()=default;
private:QTableWidget* table;//数据操作QLabel* name;QLineEdit* name_edit;QPushButton* add;QLabel* gender;QLineEdit* gender_edit;QPushButton* insert;QLabel* age;QLineEdit* age_edit;QPushButton* del;QLabel* province;QLineEdit* province_edit;QPushButton* mod;};
#endif // WIDGET_H

 学习链接：https://github.com/0voice