【嵌入式——QT】QTableWidget

表格小部件为应用程序提供标准的表格显示功能。QTableWidget中的项由QTableWidgetItem提供。

如果你想要一个使用你自己的数据模型的表，你应该使用QTableView而不是这个类。

常用函数

cellWidget(int row, int column) const：返回显示在给定行和列的单元格中的小部件；
closePersistentEditor(QTableWidgetItem *item)：关闭item的持久编辑器；
column(const QTableWidgetItem *item) const：返回该项的列；
columnCount() const：返回列数；
currentColumn() const：返回当前项的列；
currentItem() const：返回当前项；
currentRow() const：返回当前行；
editItem(QTableWidgetItem *item)：如果项目是可编辑的，则开始编辑它；
item(int row, int column) const：如果给定的行和列已经设置，则返回对应的项;否则返回nullptr；
itemAt(const QPoint &point) const：返回指向给定点上的项的指针，如果point没有被表部件中的项覆盖，则返回nullptr；
removeCellWidget(int row, int column)：删除行和列指示的单元格上设置的小部件；
row(const QTableWidgetItem *item) const：返回该项的行；
rowCount() const：返回行数；
setColumnCount(int columns)：设置列数；
setCurrentCell(int row, int column)：将当前单元格设置为位置(行、列)处的单元格；
setCurrentItem(QTableWidgetItem *item)：将当前项设置为项；
setHorizontalHeaderItem(int column, QTableWidgetItem *item)：将"列"的水平标题项设置为"项"。如果有必要，列数会增加以适应项目。删除前一个首部项(如果有的话)；
setHorizontalHeaderLabels(const QStringList &labels)：使用labels设置水平标题标签；
setItem(int row, int column, QTableWidgetItem *item)：将给定行和列的项设置为项；
setRowCount(int rows)：将这个表的模型中的行数设置为rows；
setVerticalHeaderItem(int row, QTableWidgetItem *item)：将行的垂直标题项设置为项；
setVerticalHeaderLabels(const QStringList &labels)：使用labels设置垂直标题标签；
takeItem(int row, int column)：从表中删除行和列的项，但不删除它；

信号

cellActivated(int row, int column)：当按行和列指定的单元被激活时，发出此信号；
cellChanged(int row, int column)：当由行和列指定的单元格中的项的数据发生更改时，就会发出此信号；
cellClicked(int row, int column)：每当单击表格中的一个单元格时，就会发出这个信号。指定的行和列是单击的单元格；
cellDoubleClicked(int row, int column)：每当双击表格中的一个单元格时，就会发出这个信号。指定的行和列是单击的单元格；
cellEntered(int row, int column)：当鼠标光标进入一个单元格时，就会发出这个信号。单元格由行和列指定；
cellPressed(int row, int column)：每当按下表格中的一个单元格时，就会发出这个信号。指定的行和列是按下的单元格；
void currentCellChanged(int currentRow, int currentColumn, int previousRow, int previousColumn)：每当当前单元格发生变化时，该信号就会发出。previousRow和previousColumn指定的单元格是之前获得焦点的单元格，currentRow和currentColumn指定的单元格是新的当前单元格；
currentItemChanged(QTableWidgetItem *current, QTableWidgetItem *previous)：每当当前元素发生变化时，就会发出这个信号。previous item是之前拥有焦点的项，current是新的当前项；
itemActivated(QTableWidgetItem *item)：当指定的元素被激活时，就会发出这个信号；
itemChanged(QTableWidgetItem *item)：每当item的数据发生变化时，就会发出这个信号；
itemClicked(QTableWidgetItem *item)：每当单击表中的某个元素时，就会发出这个信号。指定的项目是被单击的项目；
itemDoubleClicked(QTableWidgetItem *item)：每当双击表中的一个元素时，就会发出这个信号。指定的项是被双击的项；
itemEntered(QTableWidgetItem *item)：当鼠标光标进入某个元素时，就会发出这个信号。项目就是输入的项目；
itemPressed(QTableWidgetItem *item)：每当按下表中的一个元素时，就会发出这个信号。指定的项目是按下的项目；
itemSelectionChanged()：每当选择发生变化时，就会发出这个信号；

槽函数

clear()：删除视图中的所有项。这也将删除所有的选择和标题；
clearContents()：从视图中删除所有不在标题中的项。这也将删除所有的选择。表的维度保持不变；
insertColumn(int column)：在列处向表中插入一个空列；
insertRow(int row)：在表的row处插入一个空行；
removeColumn(int column)：从表中删除列及其所有项；
removeRow(int row)：从表中删除行及其所有项；
scrollToItem(const QTableWidgetItem *item, QAbstractItemView::ScrollHint hint = EnsureVisible：如果需要，滚动视图以确保项目可见；

QTableWidgetItem

表项用于保存表小部件的信息片段。项目通常包含文本、图标或复选框

QTableWidgetItem类是一个方便类，它取代了Qt 3中的QTableItem类。它提供了一个与QTableWidget类一起使用的项。

QTableWidgetItem常用函数

background() const：返回用于渲染项目背景的画笔；
checkState() const：返回表项的已检状态；
column() const：返回表中项的列。如果某项不在表中，这个函数将返回-1；
data(int role) const：返回指定角色的项数据；
flags() const：返回用于描述项的标志。它们决定是否可以检查、编辑和选择项目；
font() const：返回用于渲染项目文本的字体；
isSelected() const：如果选中项，则返回true，否则返回false；
read(QDataStream &in)：从流中读取项目；
write(QDataStream &out) const：将项写入流输出；
row() const：返回表中项目的行。如果某项不在表中，这个函数将返回-1；
setCheckState(Qt::CheckState state)：将表项的检查状态设置为state；
setData(int role, const QVariant &value)：为给定角色设置项的数据为指定的值；
setFlags(Qt::ItemFlags flags)：将项的标志设置为给定的标志。它们决定了是否可以选择或修改项；
setText(const QString &text)：将项的文本设置为指定的文本；
setTextAlignment(int alignment)：将项目文本的文本对齐方式设置为指定的对齐方式；

图示

代码示例
QTableWidgetDialog.h

cpp 复制代码

#ifndef QTABLEWIDGETDIALOG_H
#define QTABLEWIDGETDIALOG_H

#include <QDialog>
#include <QLabel>
namespace Ui
{
    class QTableWidgetDialog;
}

enum CellType {ctName = 1000, ctSex, ctBirth, ctNation, ctPartyM, ctScore};
enum FieldColNum {colName=0, colSex, colBirth, colNation, colScore, colPartyM};

class QTableWidgetDialog : public QDialog
{
    Q_OBJECT

public:
    explicit QTableWidgetDialog(QWidget* parent = nullptr);
    ~QTableWidgetDialog();
    void init();

    void createItemARow(int rowNo, QString name, QString sex, QDate birth, QString nation, bool isPm, int score);
private slots:
    void on_pbSetHeader_clicked();

    void on_pbInit_clicked();

    void on_pbSetCountRow_clicked();

    void on_pbGetData_clicked();

    void on_tableWidget_currentCellChanged(int currentRow, int currentColumn, int previousRow, int previousColumn);

    void on_pbInsertRow_clicked();

    void on_pbAddRow_clicked();

    void on_pbRemoveCurRow_clicked();

    void on_pbAutoRowh_clicked();

    void on_pbAutoColw_clicked();

    void on_checkBoxEdit_clicked(bool checked);

    void on_checkBoxRowHeader_clicked(bool checked);

    void on_checkBoxColHeader_clicked(bool checked);

    void on_checkBoxColor_clicked(bool checked);

    void on_radioButtonRow_clicked();

    void on_radioButtonItem_clicked();

private:
    Ui::QTableWidgetDialog* ui;

    QLabel* labCellIndex;
    QLabel* labCellType;
    QLabel* labStudID;

};

#endif // QTABLEWIDGETDIALOG_H

QTableWidgetDialog.cpp

cpp 复制代码

#include "QTableWidgetDialog.h"
#include "ui_QTableWidgetDialog.h"
#include <QDate>
#include <QIcon>
#include <QDebug>
QTableWidgetDialog::QTableWidgetDialog(QWidget* parent)
    : QDialog(parent)
    , ui(new Ui::QTableWidgetDialog)
{
    ui->setupUi(this);
    init();
}

QTableWidgetDialog::~QTableWidgetDialog()
{
    delete ui;
}

void QTableWidgetDialog::init()
{
    ui->spinBoxCount->setMaximum(10000);
}

void QTableWidgetDialog::on_pbSetHeader_clicked()
{
    QTableWidgetItem* headerItem;
    QStringList headerText;
    headerText<<"姓名"<<"性别"<<"出生日期"<<"民族"<<"分数"<<"是否党员";
    ui->tableWidget->setColumnCount(headerText.count());
    ui->tableWidget->horizontalHeader()->setMinimumHeight(50);
    for(int i=0; i<ui->tableWidget->columnCount(); i++) {
        headerItem = new QTableWidgetItem(headerText.at(i));
        QFont font = headerItem->font();
        font.setBold(true);
        font.setPointSize(12);
        headerItem->setTextColor(Qt::red);
        //设置单元格显示字体
        headerItem->setFont(font);
        ui->tableWidget->setHorizontalHeaderItem(i, headerItem);
    }
}


void QTableWidgetDialog::on_pbInit_clicked()
{
    QString strName, strSex;
    bool isParty = false;
    QDate birth;
    birth.setDate(1995, 1, 1);
    //清除表格数据区数据 但是不清除表头
    ui->tableWidget->clearContents();
    //返回数据区行数
    int rows = ui->tableWidget->rowCount();
    for(int i=0; i<rows; i++) {
        strName = QString::asprintf("学生%d", i);
        if((i % 2)==0) {
            strSex = "man";
        } else {
            strSex = "woman";
        }
        createItemARow(i, strName, strSex, birth, "汉族", isParty, 70);
        birth=birth.addDays(20);
        isParty = !isParty;
    }
}

void  QTableWidgetDialog::createItemARow(int rowNo, QString name, QString sex, QDate birth, QString nation, bool isPm, int score)
{
    QTableWidgetItem* item;
    QString str;
    uint studID = 201605000;
    item = new QTableWidgetItem(name, ctName);
    item->setTextAlignment(Qt::AlignHCenter | Qt::AlignVCenter);
    //设置单元格前景色
    // item->setForeground(Qt::darkGray);
    //设置一个图标
    // item->setIcon();
    //设置属性标记
    // item->setFlags(Qt::ItemIsSelectable);
    studID+=rowNo;
    item->setData(Qt::UserRole, QVariant(studID));
    ui->tableWidget->setItem(rowNo, colName, item);
    item = new QTableWidgetItem(sex, ctSex);
    item->setTextAlignment(Qt::AlignHCenter | Qt::AlignVCenter);
    ui->tableWidget->setItem(rowNo, colSex, item);
    str = birth.toString("yyyy-MM-dd");
    item = new QTableWidgetItem(str, ctBirth);
    item->setTextAlignment(Qt::AlignHCenter | Qt::AlignVCenter);
    ui->tableWidget->setItem(rowNo, colBirth, item);
    item = new QTableWidgetItem(nation, ctNation);
    item->setTextAlignment(Qt::AlignHCenter | Qt::AlignVCenter);
    ui->tableWidget->setItem(rowNo, colNation, item);
    str.setNum(score);
    item = new QTableWidgetItem(str, ctScore);
    item->setTextAlignment(Qt::AlignHCenter | Qt::AlignVCenter);
    ui->tableWidget->setItem(rowNo, colScore, item);
    item = new QTableWidgetItem("党员", ctPartyM);
    if(isPm) {
        //设置单元格勾选状态
        item->setCheckState(Qt::Checked);
    } else {
        item->setCheckState(Qt::Unchecked);
    }
    // //设置单元格背景颜色
    item->setBackground(Qt::yellow);
    item->setTextAlignment(Qt::AlignHCenter | Qt::AlignVCenter);
    ui->tableWidget->setItem(rowNo, colPartyM, item);
}



void QTableWidgetDialog::on_pbSetCountRow_clicked()
{
    ui->tableWidget->setRowCount(ui->spinBoxCount->text().toInt());
}


void QTableWidgetDialog::on_pbGetData_clicked()
{
    QString str;
    QTableWidgetItem* cellItem;
    ui->textEdit->clear();
    for(int i=0; i<ui->tableWidget->rowCount(); i++) {
        str = QString::asprintf("%d ", i+1);
        for(int j=0; j<ui->tableWidget->columnCount()-1; j++) {
            cellItem = ui->tableWidget->item(i, j);
            str = str+cellItem->text() + " ";
        }
        cellItem = ui->tableWidget->item(i, colPartyM);
        if(cellItem->checkState()==Qt::Checked) {
            str = str+tr("partyM");
        } else {
            str = str+tr("general");
        }
        ui->textEdit->append(str);
    }
}

//单元格切换 触发该信号
void QTableWidgetDialog::on_tableWidget_currentCellChanged(int currentRow, int currentColumn, int previousRow, int previousColumn)
{
    QTableWidgetItem* curItem =ui->tableWidget->item(currentRow, currentColumn);
    if(curItem == NULL) {
        return;
    }
    QString curstr = QString::asprintf("currentRow currentColumn :%d ,%d", currentRow, currentColumn);
    QString prestr = QString::asprintf("previousRow previousColumn :%d,%d", previousRow, previousColumn);
    qDebug()<<"curstr"<<curstr<<"prestr"<<prestr;
}


//插入
void QTableWidgetDialog::on_pbInsertRow_clicked()
{
    int curRow = ui->tableWidget->currentRow();
    ui->tableWidget->insertRow(curRow);
    createItemARow(curRow, "stu2", "man", QDate::fromString("1996-1-1", "yyyy-M-d"), "满族", false, 66);
}


void QTableWidgetDialog::on_pbAddRow_clicked()
{
    int rowCounts = ui->tableWidget->rowCount();
    ui->tableWidget->insertRow(rowCounts);
    createItemARow(rowCounts, "stu1", "man", QDate::fromString("1996-1-1", "yyyy-M-d"), "满族", false, 55);
}


void QTableWidgetDialog::on_pbRemoveCurRow_clicked()
{
    int curRow = ui->tableWidget->currentRow();
    ui->tableWidget->removeRow(curRow);
}


void QTableWidgetDialog::on_pbAutoRowh_clicked()
{
    ui->tableWidget->resizeRowsToContents();
}


void QTableWidgetDialog::on_pbAutoColw_clicked()
{
    ui->tableWidget->resizeColumnsToContents();
}


void QTableWidgetDialog::on_checkBoxEdit_clicked(bool checked)
{
    if(checked) {
        //双击或者获取焦点后单击进入编辑状态
        ui->tableWidget->setEditTriggers(QAbstractItemView::DoubleClicked | QAbstractItemView::SelectedClicked);
    } else {
        ui->tableWidget->setEditTriggers(QAbstractItemView::NoEditTriggers);
    }
}


void QTableWidgetDialog::on_checkBoxRowHeader_clicked(bool checked)
{
    ui->tableWidget->horizontalHeader()->setVisible(checked);
}


void QTableWidgetDialog::on_checkBoxColHeader_clicked(bool checked)
{
    ui->tableWidget->verticalHeader()->setVisible(checked);
}


void QTableWidgetDialog::on_checkBoxColor_clicked(bool checked)
{
    ui->tableWidget->setAlternatingRowColors(checked);
}


void QTableWidgetDialog::on_radioButtonRow_clicked()
{
    ui->tableWidget->setSelectionBehavior(QAbstractItemView::SelectRows);
}


void QTableWidgetDialog::on_radioButtonItem_clicked()
{
    ui->tableWidget->setSelectionBehavior(QAbstractItemView::SelectItems);
}