Qt 基于QAbstractTableModel自定义TableModel

原创 已于 2025-10-27 16:20:45 修改 · 492 阅读 · 4 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#qt #数据库 #开发语言

于 2025-01-06 16:50:29 首次发布
前言

平时用Qt的QTableWidget，后面感觉数据多的时候就改用QTableView了，model用的Qt自带的QStandardItemModel，但是数据过多还是会卡顿，而且QStandardItemModel功能很多，里面很多自己用不到的信号和槽，所以后面基于QAbstractTableModel自定义了自己的模型TableModel。

实现效果

插入一百万条数据，大概需要5s左右吧，然后设置单双行背景不一样，点击表格项显示提示信息。注意这里添加数据的时候不是一条一条数据添加的，因为循环调用==beginResetModel()和endResetModel()==函数就会很卡。所以我是自定义了一个函数，可以一次新建多行数据。
效果图

需要实现的函数

想要自己的自定义Model能用起来，就必须实现基类QAbstractTableModel里的一些接口。如下：

// 返回行数
    int rowCount(const QModelIndex &parent = QModelIndex()) const override;
    // 返回列数
    int columnCount(const QModelIndex &parent = QModelIndex()) const override;
    // 根据模型索引返回当前的数据
    QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override;
    // 设置表格是否可编辑
    Qt::ItemFlags flags(const QModelIndex &index) const override;
    // 设置value数据给index处的role角色
    bool setData(const QModelIndex& index, const QVariant &value, int role=Qt::EditRole) override;
    // 返回表头
    QVariant headerData(int section, Qt::Orientation orientation, int role) const override;

rowCount接口返回的是行数，我是将数据存到QList里，然后返回这个QList的size();
columnCount接口返回的是列数，我是将水平表头保存到QStringList里，然后返回这个QStringList的size();
data接口比较重要，表格会一直调用该函数来获取当前数据以及一些其他信息;
flags接口影响表格是否可编辑，如果自定义表格需要双击表格可编辑数据的话，需要实现该接口和setData接口，后者用来处理编辑表格后数据怎么保存;
headerData返回水平方向或者垂直方向的表头。
以上所有接口都定义好之后自己的自定义TableModel基本就可以用了，后面的大部分自定义函数基本都是针对数据进行处理。

int MyTableModel::rowCount(const QModelIndex &parent) const
{
    if (parent.isValid()) {
        return 0;
    } else {
        return m_datas.size();
    }
}

int MyTableModel::columnCount(const QModelIndex &parent) const
{
    if (parent.isValid()) {
        return 0;
    } else {
        return m_HorizontalHead.size();
    }
}

QVariant MyTableModel::data(const QModelIndex &index, int role) const
{
    if (!index.isValid()) {
        return QVariant();
    }

    if (role == Qt::DisplayRole ||  role == Qt::EditRole) {
        return m_datas[index.row()][index.column()];//数据的呈现形式
    }else if(role == Qt::BackgroundColorRole){
        if(index.row() % 2 == 0)
            return QColor(192,192,192);//单元格背景色
        else
            return QColor(159,252,252);//单元格背景色
    }
    else if (role == Qt::TextAlignmentRole) {    //对其方式
        return Qt::AlignCenter;
    }
    else if(role == Qt::ToolTipRole){
        return m_datas[index.row()][index.column()];//数据的提示信息
    }

    return QVariant();
}

Qt::ItemFlags MyTableModel::flags(const QModelIndex &index) const
{
    if (!index.isValid())
        return Qt::NoItemFlags;

    return Qt::ItemIsEnabled|Qt::ItemIsSelectable|Qt::ItemIsEditable;
}

bool MyTableModel::setData(const QModelIndex &index, const QVariant &value, int role)
{
    if (index.isValid() && role == Qt::EditRole)
    {
        m_datas[index.row()][index.column()] = value.value<QString>();
        emit dataChanged(index, index, QVector<int>() << role);                     //发送信号触发刷新
        return true;
    }

    return false;
}

QVariant MyTableModel::headerData(int section, Qt::Orientation orientation, int role) const {
    if (role != Qt::DisplayRole) // 返回一个默认数据的表头
        return QAbstractTableModel::headerData(section, orientation, role);

    // 仅仅只是返回水平方向的表头
    if (orientation == Qt::Orientation::Horizontal) {
        if(m_HorizontalHead.size() >= m_datas.size())
            return this->m_HorizontalHead[section];
    }

    return QAbstractTableModel::headerData(section, orientation, role);
}
对数据处理时注意事项

对自己的数据处理之前要调用beginResetModel()，对数据处理完之后要调用endResetModel()；有时候界面比较卡顿主要是添加数据的时候可能是一条条添加，中间调用太多次这两个函数了。

MyTableModel头文件代码
#ifndef MYTABLEMODEL_H
#define MYTABLEMODEL_H

#include <QObject>
#include <QAbstractTableModel>
#include <QColor>

typedef QStringList TableRowData;
typedef QList<QStringList> TableRowDatas;

class MyTableModel : public QAbstractTableModel
{
    Q_OBJECT
public:
    explicit MyTableModel(QObject *parent = nullptr);

public:
    // 返回行数
    int rowCount(const QModelIndex &parent = QModelIndex()) const override;
    // 返回列数
    int columnCount(const QModelIndex &parent = QModelIndex()) const override;
    // 根据模型索引返回当前的数据
    QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override;
    // 设置表格是否可编辑
    Qt::ItemFlags flags(const QModelIndex &index) const override;
    // 设置value数据给index处的role角色
    bool setData(const QModelIndex& index, const QVariant &value, int role=Qt::EditRole) override;
    // 返回表头
    QVariant headerData(int section, Qt::Orientation orientation, int role) const override;

///// 自定义函数
    ///< 设置水平方向表头
    void setHorizontalHeader(QStringList header);
    ///< 设置垂直方向表头
    void setVerticalHeader(QStringList header);
    ///< 设置最大行数
    void setMaxRow(int size);
    ///< 增加行
    bool appendRow(TableRowData rowData = TableRowData());
    ///< 增加多行
    bool appendRowS(int count,TableRowDatas tableRowDatas = TableRowDatas());
    ///< 插入行
    bool insertRow(int row,TableRowData rowData = TableRowData());
    ///< 插入多行
    bool insertRowS(int row,int count,TableRowDatas tableRowDatas = TableRowDatas());
    ///< 删除行
    bool removeRow(int row);
    ///< 行数据
    QStringList rowTset(int row);
    ///< 单元格数据
    QString itemText(int row,int column);
    ///< 删除所有单元格
    void clear();
private:
    // 如果字符串列比总列数小 则补空字符串
    void CompleteList(QStringList& list);
    // 检查数据 如果行数最大值超过所设置的值 则将较老的数据删除
    void maxRowCheck();

private:
    int m_rowNum;                           //  行大小
    int m_maxRow;                           //  最大行
    QStringList m_HorizontalHead;           //  水平方向表头
    QStringList m_VerticalHeader;           //  水平方向表头
    TableRowDatas m_datas;                  //  数据
};

#endif // MYTABLEMODEL_H
MyTableModel cpp文件代码
#include "mytablemodel.h"
#include <QtMath>
#include <QColor>

MyTableModel::MyTableModel(QObject *parent) : QAbstractTableModel(parent)
{
    m_maxRow = 1000000;
}

int MyTableModel::rowCount(const QModelIndex &parent) const
{
    if (parent.isValid()) {
        return 0;
    } else {
        return m_datas.size();
    }
}

int MyTableModel::columnCount(const QModelIndex &parent) const
{
    if (parent.isValid()) {
        return 0;
    } else {
        return m_HorizontalHead.size();
    }
}

QVariant MyTableModel::data(const QModelIndex &index, int role) const
{
    if (!index.isValid()) {
        return QVariant();
    }

    if (role == Qt::DisplayRole ||  role == Qt::EditRole) {
        return m_datas[index.row()][index.column()];//数据的呈现形式
    }else if(role == Qt::BackgroundColorRole){
        if(index.row() % 2 == 0)
            return QColor(192,192,192);//单元格背景色
        else
            return QColor(159,252,252);//单元格背景色
    }
    else if (role == Qt::TextAlignmentRole) {    //对其方式
        return Qt::AlignCenter;
    }
    else if(role == Qt::ToolTipRole){
        return m_datas[index.row()][index.column()];//数据的提示信息
    }

    return QVariant();
}

Qt::ItemFlags MyTableModel::flags(const QModelIndex &index) const
{
    if (!index.isValid())
        return Qt::NoItemFlags;

    return Qt::ItemIsEnabled|Qt::ItemIsSelectable|Qt::ItemIsEditable;
}

bool MyTableModel::setData(const QModelIndex &index, const QVariant &value, int role)
{
    if (index.isValid() && role == Qt::EditRole)
    {
        m_datas[index.row()][index.column()] = value.value<QString>();
        emit dataChanged(index, index, QVector<int>() << role);                     //发送信号触发刷新
        return true;
    }

    return false;
}

QVariant MyTableModel::headerData(int section, Qt::Orientation orientation, int role) const {
    if (role != Qt::DisplayRole) // 返回一个默认数据的表头
        return QAbstractTableModel::headerData(section, orientation, role);

    // 仅仅只是返回水平方向的表头
    if (orientation == Qt::Orientation::Horizontal) {
        if(m_HorizontalHead.size() >= m_datas.size())
            return this->m_HorizontalHead[section];
    }

    return QAbstractTableModel::headerData(section, orientation, role);
}

void MyTableModel::setHorizontalHeader(QStringList header)
{
    m_HorizontalHead = header;
}

void MyTableModel::setVerticalHeader(QStringList header)
{
    m_VerticalHeader = header;
}

void MyTableModel::setMaxRow(int size)
{
    m_maxRow = size;
}

bool MyTableModel::appendRow(QStringList rowData)
{
    CompleteList(rowData);
    beginResetModel();
    m_datas.append(rowData);
    maxRowCheck();
    endResetModel();
    return true;
}

bool MyTableModel::appendRowS(int count,TableRowDatas tableRowDatas)
{
    beginResetModel();
    for(int i = 0; i < count;i++)
    {
        TableRowData rowData;
        if(tableRowDatas.size() > i)
            rowData = tableRowDatas[i];

        CompleteList(rowData);
        m_datas.append(rowData);
        maxRowCheck();
    }

    endResetModel();
    return true;
}

bool MyTableModel::insertRow(int row,TableRowData rowData)
{
    CompleteList(rowData);
    if(row < m_datas.size())
    {
        beginResetModel();
        m_datas.insert(row,rowData);
        maxRowCheck();
        endResetModel();
        return true;
    }

    return false;
}

bool MyTableModel::insertRowS(int row,int count,TableRowDatas tableRowDatas)
{
    if(row < m_datas.size())
    {
        beginResetModel();
        for(int i = 0; i < count;i++)
        {
            TableRowData rowData;
            if(tableRowDatas.size() > i)
                rowData = tableRowDatas[i];

            CompleteList(rowData);
            m_datas.insert(row+i,rowData);
            maxRowCheck();
        }
        endResetModel();
        return true;
    }

    return false;
}

bool MyTableModel::removeRow(int row)
{
    if(row < m_datas.size()){
        beginResetModel();
        m_datas.removeAt(row);
        endResetModel();
        return true;
    }

    return false;
}

QStringList MyTableModel::rowTset(int row)
{
    if(row < m_datas.size())
        return m_datas[row];

    return  QStringList();
}

QString MyTableModel::itemText(int row,int column)
{
    if(row < m_datas.size() && column < m_HorizontalHead.size())
        return m_datas[row][column];

    return "";
}

void MyTableModel::clear()
{
    beginResetModel();
    m_datas.clear();
    endResetModel();
}

void MyTableModel::CompleteList(QStringList& list)
{
    if(list.size() < m_HorizontalHead.size())
    {
        for(int i = list.size();i <= m_HorizontalHead.size();i++)
        {
            list.append("");
        }
    }
}

void MyTableModel::maxRowCheck()
{
    if(m_maxRow > 0 && m_datas.size() > m_maxRow)
    {
        int curRowCount = m_datas.size();
        for(int i = 0; i < curRowCount-m_maxRow;i++)
        {
            m_datas.removeFirst();
        }
    }
}
结束语

自定义model的增删改查写好了，接下来想试试QStyledItemDelegate代理，用它修改View的表头格式，实现排序查找等功能。

Qt 继承QAbstractTableModel实现自定义TableModel
希望能帮助大家，希望大家多多支持，你们的支持是我前进的动力。
11-06 2325
QAbstractTableModel为将数据表示为二维项数组的模型提供了一个标准接口。它不直接使用，但必须进行子类化。由于该模型提供了比QAbstractItemModel更专业的接口，因此它不适合与树视图一起使用，尽管它可以用于向QListView提供数据。如果需要表示一个简单的项列表，并且只需要一个模型包含一列数据，那么将QAbstractListModel子类化可能更合适。
【QT开发】抽象列表模型QAbstractListModel类详解及实战应用
科技改变人类，技术成就未来
07-07 1624
QAbstractListModel是Qt提供的一个功能强大且灵活的抽象列表模型类，通过本篇文章的学习，你应该对QAbstractListModel有了全面的理解，能够在自己的项目中正确使用它。QAbstractListModel在用户界面中帮助你更好地管理和操作列表数据，实现交互式和响应式的应用程序，有助于创建用户友好和高效的数据列表、数据选择组件等应用场景。
QT模型视图MVC系列教程（3）---自定义模型，以QAbstractTableModel为例
野生猿-群号1025127672
02-02 2847
MVC中的M就是模型Model，QT中所有的模型都继承自：QAbstractItemModel 查阅手册可知，它的子类有3个： 分别是列表模型、代理模型、表格模型。 要实现自定义模型，可以继承QAbstractItemModel以及任何一个后代类（含子类、孙子类。。。等），按照QT的设计管理，名字里带抽象字样Abstract的类，都不能直接使用，必须继承并自行实现某些特定函数；对于QT自带的不带Abstract字样的Model类，可以不用继承重写，直接new出来使用即可，这种情形较为简单。所以本文
Qt Model/View 学习(4) - 实现自己的QAbstractTableModel类（支持显示与修改）
Copperxcx的博客
12-24 9760
实现Qt Model/View框架中的自定义Model类，以及示例工程~
qt自定义model（QAbstractTableModel）
我不是码农的博客~~~
09-06 3086
1.MyTableModel.h #pragma once #include <QAbstractTableModel> class MyTableModel : public QAbstractTableModel { Q_OBJECT public: MyTableModel(QObject *parent = nullptr); ~MyTableModel(); void SetHeadData(const QStringList& list)
qt QAbstractTableModel详解
最新发布
ckg3824278的博客
11-06 1358
QAbstractTableModel 是 Qt 框架中的一个类，用于在 Qt 应用程序中实现自定义的表格数据模型。它是 Qt 中的一个抽象基类，提供了创建和操作表格数据所需的接口。QAbstractTableModel 为模型提供了一个标准接口，这些模型将其数据表示为二维项目数组，适用于向 QTableView 或 QML 中的 TableView 组件提供数据，用于显示和编辑。
(四)Qt实现自定义模型基于QAbstractTableModel
qimo601的专栏
05-17 812
  目录： (一) Qt Model/View 的简单说明 、预定义模型 (二)使用预定义模型 QstringListModel例子 (三)使用预定义模型QDirModel的例子 (四)Qt实现自定义模型基于QAbstractTableModel (五)Qt实现自定义模型基于QAbstractItemModel  (六) Qt实现自定义委托 QDelegate   ...
Qt自定义TableModel与SqlModel应用实例分析
在讨论Qt框架中自定义TableModel和使用SqlModel的实现过程时，首先需要了解Qt以及Qt Model/View编程的基础知识。Qt是一个跨平台的C++应用程序框架，广泛用于开发GUI程序以及非GUI程序，如命令行工具和服务器。而...
qt 自定义tablemodel和使用sqlmodel的例子
05-22
我们将通过分析"qt 自定义tablemodel和使用sqlmodel的例子"中的`TableModelView.zip`和`SqliteExample.zip`两个压缩包文件来阐述相关知识点。 首先，让我们看看自定义`QAbstractTableModel`。`QAbstractTableModel`...
QT利用QTableView和自定义Model实现一个增删改查等功能超全的复用型表格
CodeWorld1999的博客
03-14 5080
自定义Model实现一个增删改查等功能的复用型表格TableView——未链接数据库版（动图展示效果并内附完整Demo）
使用QAbstractTableModel来自定义表格模型，并在QTableView中显示数据
QtCompany的博客
04-24 1242
在这个示例中，我们创建了一个自定义的表格模型TableModel，它继承自QAbstractTableModel，并实现了三个虚函数：rowCount、columnCount和data。其中，rowCount返回表格行数，columnCount返回表格列数，data返回指定索引位置的数据。在MainWindow中，我们创建了一个QTableView和一个表格模型TableModel，并通过setModel函数将表格模型设置到表格视图中。运行程序后，即可看到包含3行3列数据的表格。
qt5-入门-ModelView架构3-自定义Model（只读）
陆沙的博客
04-01 685
qt5，自定义model
Qt58 自定义模型类1，QStandardItemModel通用模型类，QVariant变体类
奶牛养殖场小马
05-05 545
学习自唐佐林老师的Qt main.cpp #include <QtCore/QCoreApplication> #include <QVariant> #include <QPoint> #include <QDebug> QVariant func() { QVariant ret; return ret;//返回值类型可变 } int main(int argc, char *argv[]) { QCoreAppli
QAbstractTableModel基本使用：数据加载以及增删行列
热门推荐
龚建波
09-17 2万+
前言 QAbstractTableModel 继承自QAbstractItemModel，主要用于为 QTableView 提供相关接口，我们可以子类化该抽象类并实现相关接口。本文主要讲QAbstractTableModel 数据的加载与更新，以及行列的增删。 （请确保自己已经熟悉了 rowCount、columnCount、data 等基础的接口） 加载数据并刷新 当我们想重置 model 的数据时，可以将重置的逻辑放在beginResetModel 和endResetModel 两个函数...
自定义模型类
qq_52484093的博客
01-21 349
QStandardItemModel 是一个通用的模型类 能够以任意的方式组织数据 数据组织的基本单位为数据项 (QStandardItem) 每一个数据项能够存储多个具体数据 (附加数据角色) 每一个数据项能够对数据状态进行控制 (可编辑，可选，...) Qt 中通用的模型类 QStandardItemModel Qt 中的变体类型 QVariant QVariant 是一个用于封装的类型 QVariant 能够表示大多数常见的值类型 QVariant 每次只能封装 (保
【QT】学习之TableWidget设置自定义表头checkbox选择
Peggy0的博客
09-04 1644
表格内每行插入数据时候也要插入checkbox。所以在每次插入一行数据的位置第一列先放入一个复选框。先来看效果，在tablewidget表头第一列有一个checkbox选择框。在主界面 .h 包含自定义的表头类名称。这里初始化表格函数里面使用。需要自定义表头类继承HeaderView。这个选择框实现对下面所有项的全选功能。
Qt开发-自定义模型类(上)
hw5230的博客
02-11 475
1、QStandardItemModel是一个通用的模型类（1）、能够以任意的方式组织数据（线程、非线性）（2）、数据组织的基本单位为数据项（QStandardItem）（3）、每一个数据项能够存储多个具体数据（附加数据角色）（4）、每一个数据项能够对数据状态进行控制（可编辑、可选...）2、Qt中的通用模型类QStandardItemModel（1）、QStandardItemModel继承自抽象的模型类QAbstractItemModel。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值