表格控件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_OBJECT

public:
    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();

            //获取当前行中每一个item
            name_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行，那么要先把行数+n
            int 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