QAbstractTableModel基本使用：排序相关接口

￡神魔★判官ぃ 2022-12-08 06:03 183阅读 0赞

# 前言 #

QAbstractTableModel 继承自 QAbstractItemModel，主要用于为 QTableView 提供相关接口，我们可以子类化该抽象类并实现相关接口。本文主要讲 QAbstractTableModel 提供的 sort 接口的相关细节。

（请确保自己已经熟悉了 rowCount、columnCount、data 等基础的接口）

# 使用 QTableView 的排序功能 #

QTableView 有个 setSortingEnabled 接口，设置为 true 后，我们就可以通过点击表头根据某一列的数据进行排序，支持升序和降序。

点击表头排序的时候，最终回调的就是 model 的 sort 接口，该接口的默认实现是空的，所以我们只开启 view 的排序还不能完成这个功能。有两种方式可以实现排序：

第一是使用 QSortFilterProxyModel ，该接口提供了排序的默认实现，如果要自定义排序规则可以重新实现其 lessThan 接口。使用它的好处是 reset model 数据后排序依然有效。不方便的是他的排序只是改变了单元格的显示位置索引，数据其实是没有修改顺序的，这就导致排序后行号就还是原来的行号。

第二是自定义实现 model 的 sort 接口。好处是排序后直接修改的原始数据，行号是正常的升序。坏处是 reset model 后不会自动排序，需要做信号槽的关联来完成，或者加载数据时处理下；而且修改了原始数据就不能恢复未排序的状态了，我们想要恢复还得在初始加载数据的时候保留这个索引在每一行的数据里，这样在恢复默认顺序的时候根据这个索引排序。

QTableView *table=ui->tableView;
        model=new MyTableModel(ui->tableView);
        //想要利用view支持的点击表头排序功能
        //我们可以用QSortFilterProxyModel完成排序，或者实现model的sort接口来完成排序
        //其次，view要设置setSortingEnabled为true，且表头是可点击的
    #if 0
        //借助QSortFilterProxyModel
        QSortFilterProxyModel *proxy=new QSortFilterProxyModel(ui->tableView);
        proxy->setSourceModel(model);
        table->setModel(proxy);
    #else
        //借助model的sort接口，基类实现不执行任何操作，要自己实现
        table->setModel(model);
    #endif

# 实现 sort 接口 #

参照 QSortFilterProxyModel 的 sort 实现，我完成了一个简易的 sort 接口实现：

void MyTableModel::sort(int column, Qt::SortOrder order)
    {
        if(modelData.isEmpty()||column<0||column>=columnCount())
            return;
        //判断升序降序
        const bool is_asc = (order == Qt::AscendingOrder);
        //排序
        std::sort(modelData.begin(), modelData.end(),
                  [column, is_asc, this](const MyModelItem &left,const MyModelItem &right){
            //我用QVariant只是在以前的基础上改的，自定义类型可以不用这个
            //这里假设单元格数据都是任意类型的
            const QVariant left_val = left.at(column);
            const QVariant right_val = right.at(column);
    
            //辅助接口，a<b返回true
            return is_asc
                    ?lessThan(left_val,right_val)
                   :lessThan(right_val,left_val);
        });
        //更新view
        dataChanged(index(0,0),index(modelData.count()-1,columnCount()-1));
    }
    
    bool MyTableModel::lessThan(const QVariant &left, const QVariant &right) const
    {
        //参照QAbstractItemModelPrivate::isVariantLessThan的实现
        //这些都是通用型的排序规则，一般我们会有自定义的需求，比如根据字符串中的数字排序
        //有些类型需要包含头文件才能使用，如datetime
        if (left.userType() == QMetaType::UnknownType)
            return false;
        if (right.userType() == QMetaType::UnknownType)
            return true;
        switch (left.userType()) {
        case QMetaType::Int:
            return left.toInt() < right.toInt();
        case QMetaType::UInt:
            return left.toUInt() < right.toUInt();
        case QMetaType::LongLong:
            return left.toLongLong() < right.toLongLong();
        case QMetaType::ULongLong:
            return left.toULongLong() < right.toULongLong();
        case QMetaType::Float:
            return left.toFloat() < right.toFloat();
        case QMetaType::Double:
            return left.toDouble() < right.toDouble();
        case QMetaType::QChar:
            return left.toChar() < right.toChar();
        case QMetaType::QDate:
            return left.toDate() < right.toDate();
        case QMetaType::QTime:
            return left.toTime() < right.toTime();
        case QMetaType::QDateTime:
            return left.toDateTime() < right.toDateTime();
        case QMetaType::QString: break;
        default: break;
        }
        //Locale表示支持本地字符串
        //if (isLocaleAware)
        return left.toString().localeAwareCompare(right.toString()) < 0;
        //else
        //   return left.toString().compare(right.toString(), cs) < 0;
    }

对于中文字符串，可以用 QString 的 localeAwareCompare 来进行 locale 文本的排序，如果还不符合，可以调用其他库来完成。

对于数值字符串，因为字符串是根据字典值排序的，所以升序的时候 11 可能排在 2 之前，有需要我们可以对这一列进行特殊化处理，先转成数值再比较。

看下实现效果，根据第二列数值升序：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmdqaWFuYm8xOTky_size_16_color_FFFFFF_t_70][]

# 参考 #

官方文档：[https://doc.qt.io/qt-5/qabstracttablemodel.html][https_doc.qt.io_qt-5_qabstracttablemodel.html]

官方文档：[https://doc.qt.io/qt-5/model-view-programming.html][https_doc.qt.io_qt-5_model-view-programming.html]

官方文档：[https://doc.qt.io/qt-5/qabstractitemmodel.html][https_doc.qt.io_qt-5_qabstractitemmodel.html]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmdqaWFuYm8xOTky_size_16_color_FFFFFF_t_70]: /images/20221123/a68fbaefd42e49f88bd7a87d5702d1ec.png
[https_doc.qt.io_qt-5_qabstracttablemodel.html]: https://doc.qt.io/qt-5/qabstracttablemodel.html
[https_doc.qt.io_qt-5_model-view-programming.html]: https://doc.qt.io/qt-5/model-view-programming.html
[https_doc.qt.io_qt-5_qabstractitemmodel.html]: https://doc.qt.io/qt-5/qabstractitemmodel.html#headerData