Qt——自定义Model

news2024/11/18 9:48:19

众所周知，Qt提供了一套Model/View框架供开发者使用，Model用来提供数据， View则用来提供视觉层的显示。实际上这是一套遵循MVC设计模式的GUI框架，因为Qt还提供了默认的Delegate作为Controller来作为控制器。

MVC的好处这里就不多说了，为了开发者使用方便，Qt还提供了基于项（Item）的Model/View实现----QXxxWidget（QTableWidget、QListWidget等），对于一些简单的应用场景，这已经足够了并且使用起来非常方便。这里我们简单介绍下如何使用自定义的数据模型，来满足各种花式的要求。

1. 选择合适的Model继承

1.1 标准数据模型

Qt实现了4类标准数据模型供我们在不同的场景下使用：

QStringListModel：存储字符串列表。
QStandardItemModel：存储树状结构的任意数据。
QFileSystemModel：存储本地文件系统上的文件和目录信息。
QSqlQueryModel、QSqlRelationalTableModel、QSqlTableModel：存储关系型数据库中的数据。

如果使用情况和上述情况之一比较相似，则可以考虑继承对应的模型类，并重新实现少数虚函数。

1.2 抽象数据模型

抽象数据模型有3类：

QAbstractItemModel：项模型，这是所有数据模型的基类。
QAbstractListModel：列表模型，结合QListView使用最合适。
QAbstractTableModel：表模型，结合QTableView使用最合适。

2. 继承抽象模型

Qt官方提供了完善的文档来帮助开发者来自定义模型类。根据官网，子类化模型需要开发者实现的功能（即需要重新实现的虚函数）按功能来分可以分为三类：

项数据处理：这又可以分为三类----只读访问、可编辑、调整大小。
导航和下标创建。
拖拽和MIME类型处理。

我们只需要按照自己的功能需求来实现其中的一些虚函数。

3. 实现一个自定义模型

这里我们来实现一个自定义模型，并在QTableView中使用它，因此我们选择继承QAbstractTableModel，这样我们需要做的改动最少。但使用QTableModel并不意味着我们的数据结构就是Table状的，例如下面的例子中我们根本不需要内部数据结构。

下面我们要实现这样一个数据模型：

内部不存储数据结构。
表中的每一个单元获得的数据是整型，并且值为列下标的平方。
模型中的数据为只读。

3.1 实现CustomeModel

该模型继承自QAbstractTableModel，作为只读模型，我们只需要实现以下几个虚函数：

virtual Qt::ItemFlags flags(const QModelIndex &index) const;
virtual QVariant data(const QModelIndex &index, int role) const;
virtual QVariant headerData(int section, Qt::Orientation orientation, int role) const;
virtual int rowCount(const QModelIndex &parent) const;
virtual int columnCount(const QModelIndex &parent) const;
CPP 复制 全屏

data()函数与项数据有关，这里数据有好几种角色（role），最基本的就是Qt::DisplayRole，这里为了实现居中效果，我们还处理了Qt::TextAlignmentRole角色：

QVariant MyTableModel::data(const QModelIndex &index, int role) const
{
    if (role == Qt::DisplayRole) {
        return index.column() * index.column();
    }
    if (role == Qt::TextAlignmentRole) {
        return Qt::AlignCenter;
    }
    return QVariant();
}

headerData()函数提供表头数据，包括两个方向（垂直、水平）的表头。同样，这里的数据也有好几种角色，我们只处理Qt::DisplayRole：

QVariant MyTableModel::headerData(int section, Qt::Orientation orientation, int role) const
{
    if (orientation == Qt::Vertical) {
        if (role == Qt::DisplayRole)    return QVariant("row:" + QString::number(section));
        else                            return QVariant();
    }
    if (orientation == Qt::Horizontal) {
        if (role == Qt::DisplayRole)    return QVariant("column:" + QString::number(section));
        else                            return QVariant();
    }
}

rowCount()和columnCount()返回数据模父下标（QModelIndex）的行和列数量，这里我们要判别下标是否有效：因为整个表模型的父下标为无效下标，我们返回表模型的行列数量；当下标有效时，我们返回的是父下标指向处的子表的行列：

//  if `parent` is invalid, return the whole table row count!
//  else return the children row count of the `parent`
int MyTableModel::rowCount(const QModelIndex &parent) const
{
    if (parent.isValid())
        return 0;
    else
        return 10;
}