Qt--自定义Model

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

MVC-image

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

1. 选择合适的Model继承

1.1 标准数据模型

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

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

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

1.2 抽象数据模型

抽象数据模型有3类:

  1. QAbstractItemModel:项模型,这是所有数据模型的基类。
  2. QAbstractListModel:列表模型,结合QListView使用最合适。
  3. 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;

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;
}

3.2 运行结果

result-img

完整代码见此处

posted @ 2017-09-14 23:09 lgxZJ 阅读(...) 评论(...) 编辑 收藏