恋恋风辰的官方博客

Qt MVC结构之Model模型介绍
Posted on 2022-12-17 14:10:13 by 恋恋风辰 | In Qt界面 | 原文链接

MVC简介

MVC 就是Model-View-Control模式的简称，包括模型层(Model), 视图层(View), 控制层(Controller).
Model主要负责管理数据，View主要用来显示数据，Controller主要用来操作数据，控制View联动。
Qt也采用了这个模式，模型层用Model，视图层用View，控制层改名叫了代理Delegate。

QFileSystemModel

我们可以举个简单的例子，用QFileSystemModel来实现文件夹内容的展示，QFileSystemModel是Qt给我们提供的处理本地文件系统的文件和目录。

  1. int main(int argc, char *argv[])
  2. {
  3.     QApplication a(argc, argv);
  4.     QSplitter * splitter  = new QSplitter;
  5.     QFileSystemModel * model = new QFileSystemModel;
  6.     model->setRootPath(QDir::currentPath());
  8.     QTreeView * tree = new QTreeView(splitter);
  9.     tree->setModel(model);
  10.     tree->setRootIndex(model->index(QDir::currentPath()));
  12.     QListView * list = new QListView(splitter);
  13.     list->setModel(model);
  14.     list->setRootIndex(model->index(QDir::currentPath()));
  16.     splitter->setWindowTitle("Two views onto the same file system model");
  17.     splitter->resize(1000,800);
  18.     splitter->show();
  19.     return a.exec();
  20. }

为model设置根目录,目录为当前文件夹。
创建树型视图，视图加载model，并且设置视图的根索引为model的当前目录的索引。

模型介绍

模型分为几种，有列表模型，表格模型，以及树模型。详细可以参考Qt的帮主文档，搜索Model/View Programming。
https://cdn.llfc.club/1671158788602.jpg

模型有一个最基本的类QStandardItemModel，我们基于这个模型类实现一个树形模型。

  1. int main(int argc, char *argv[])
  2. {
  3.     QApplication a(argc, argv);
  4.     //创建标准itemmodel
  5.     QStandardItemModel model;
  6.     //获取模型根项，根项不可见
  7.     QStandardItem * parentItem = model.invisibleRootItem();
  8.     //创建文本显示，图标，和工具显示
  9.     QStandardItem * item0 = new QStandardItem();
  10.     item0->setText("item0");
  11.     QPixmap pixmap0(50,50);
  12.     pixmap0.fill(Qt::red);
  13.     item0->setIcon(pixmap0);
  14.     item0->setToolTip("indexA");
  15.     parentItem->appendRow(item0);
  16.     //将新的项设置为父节点项
  17.     parentItem = item0;
  19.     QStandardItem * item1 = new QStandardItem();
  20.     item1->setText("item1");
  21.     QPixmap pixmap1(50,50);
  22.     pixmap1.fill(Qt::blue);
  23.     item1->setIcon(pixmap1);
  24.     item1->setToolTip("indexB");
  25.     parentItem->appendRow(item1);
  27.     QStandardItem * item2 = new QStandardItem();
  28.     item2->setData("item2",Qt::EditRole);
  29.     QPixmap pixmap2(50,50);
  30.     pixmap2.fill(Qt::green);
  31.     item2->setData(QIcon(pixmap2), Qt::DecorationRole);
  32.     item2->setData("indexC",Qt::ToolTipRole);
  33.     parentItem->appendRow(item2);
  35.     //取出根节点第0行0列的模型索引
  36.     QModelIndex indexA = model.index(0,0, QModelIndex());
  37.     qDebug() << "model indexA row count is " << model.rowCount(indexA);
  39.     //获取indexA节点下0行0列
  40.     QModelIndex indexB = model.index(0,0,indexA);
  41.     qDebug() << "indexB text is " << model.data(indexB,Qt::EditRole).toString();
  42.     qDebug() << "indexB icon is " << model.data(indexB,Qt::DecorationRole);
  43.     qDebug() << "indexB tool tip  is " << model.data(indexB,Qt::ToolTipRole).toString();
  45.     QTreeView view;
  46.     view.setModel(&model);
  47.     view.show();
  48.     return a.exec();
  49. }

运行后程序效果图
https://cdn.llfc.club/1671159654393.jpg
item0节点下挂载了item1和item2两个节点。程序用两种方式为item设置图标，提示，文本。
一种是setText，setIcon, setToolTip方式，另一种是setData方式。
setData的方式可以参考Qt的文档，文档里列举了一些可以设置的角色。
EditRole是可编辑角色，DecorationRole类似于图片显示，ToolTipRole类似于提示的角色。

特定模型

除了QStandardItemModel之外，还有一些其他集成好的特殊模型，如果我们要实现树形模型就子类化QStandardItemModel。
如果想实现列表模型就子类化QAbstractListModel，如果像实现表格模型就子类化QAbstractTableModel。
我们子类化QAbstractListModel，实现一个列表模型。

  1. class StringListModel:public QAbstractListModel
  2. {
  3.     Q_OBJECT
  4. public:
  5.     StringListModel(const QStringList & strings, QObject* parent = 0);
  6.     int rowCount(const QModelIndex& parent = QModelIndex()) const;
  7.     QVariant data(const QModelIndex& index, int role) const;
  8.     QVariant headerData(int section, Qt::Orientation orientation,
  9.                         int role = Qt::DisplayRole) const;
  10. private:
  11.     QStringList stringList;
  12. };

这个模型类包含一个QStringList,用来管理数据

  1. StringListModel::StringListModel(const QStringList & strings,
  2.                                  QObject* parent):
  3.     QAbstractListModel(parent), stringList(strings)
  4. {
  6. }
  8. int StringListModel::rowCount(const QModelIndex& parent ) const{
  9.     return stringList.count();
  10. }
  12. QVariant StringListModel::data(const QModelIndex& index, int role) const{
  13.     if(!index.isValid()){
  14.         return QVariant();
  15.     }
  17.     if(index.row() >= stringList.size()){
  18.         return QVariant();
  19.     }
  21.     if(role == Qt::DisplayRole){
  22.         return stringList.at(index.row());
  23.     }else{
  24.         return QVariant();
  25.     }
  26. }
  28. QVariant StringListModel::headerData(int section, Qt::Orientation orientation,
  29.                                      int role ) const{
  30.     if(role != Qt::DisplayRole){
  31.         return QVariant();
  32.     }
  34.     if(orientation == Qt::Horizontal){
  35.         return QString("Column %1").arg(section);
  36.     }else{
  37.         return QString("Row %1").arg(section);
  38.     }
  39. }

headerData函数内根据水平还是垂直判断，显示表头。
data函数内根据角色返回索引对应的数据。
在main函数中可以分别用一个listview和treeview显示

  1. int main(int argc, char *argv[])
  2. {
  3.     QApplication a(argc, argv);
  4.     QStringList list;
  5.     list <<"a" << "b" << "c";
  7.     StringListModel model(list);
  8.     QListView  listView;
  9.     listView.setModel(&model);
  10.     listView.show();
  12.     QTableView tableView;
  13.     tableView.setModel(&model);
  14.     tableView.show();
  15.     return a.exec();
  16. }

https://cdn.llfc.club/1671174663824.jpg

设置可编辑选项

我们为自定义的listmodel模型添加两个函数flags()和setData()函数。
flags函数用来判断模型索引对应的项目的属性，通过标记按位或的方式获取。
setData用来设置模型索引对应的项，并且设置他的编辑属性。

  1. Qt::ItemFlags  StringListModel::flags(const QModelIndex& index) const{
  2.     if(!index.isValid())
  3.          return Qt::ItemIsEnabled;
  4.     return QAbstractItemModel::flags(index) | Qt::ItemIsEditable;
  5. }

如果是无效的数据则返回ItemIsEnabled标记，否则在原来的标记基础上增加ItemIsEditable。
当我们修改数据时，会触发setData函数, 该函数根据项的角色为EditRole替换原来的字符串。

  1. bool StringListModel::setData(const QModelIndex& index,
  2.                               const QVariant &value, int role ){
  3.     if(index.isValid() && role == Qt::EditRole){
  4.         stringList.replace(index.row(), value.toString());
  5.         emit dataChanged(index, index);
  6.         return true;
  7.     }
  8.     return false;
  9. }

并且发送了dataChanged，这个信号第一个参数为左上角的index，第二个参数为右下角index。
dataChanged通知View视图刷新数据，从而完成数据的修改。

另外Views显示数据时会根据data返回的数据显示，所以要将data函数的显示逻辑中添加Qt::EditRole。

  1. QVariant StringListModel::data(const QModelIndex& index, int role) const{
  2.     if(!index.isValid()){
  3.         return QVariant();
  4.     }
  6.     if(index.row() >= stringList.size()){
  7.         return QVariant();
  8.     }
  10.     if(role == Qt::DisplayRole || role == Qt::EditRole){
  11.         return stringList.at(index.row());
  12.     }else{
  13.         return QVariant();
  14.     }
  15. }

添加行与删除行

添加行和删除行都需要在添加和删除之前调用begin操作，操作完之后调用end操作

  1. bool StringListModel::insertRows(int position, int rows,
  2.                                  const QModelIndex & index ){
  3.     beginInsertRows(QModelIndex(), position, position + rows -1);
  4.     for(int row = 0; row < rows; ++ row){
  5.         stringList.insert(position, "");
  6.     }
  7.     endInsertRows();
  8.     return true;
  9. }
  11. bool StringListModel::removeRows(int position, int rows,
  12.                                  const QModelIndex & index ){
  13.     beginRemoveRows(QModelIndex(), position, position+ rows-1);
  14.     for(int row=0; row < rows; ++ row){
  15.         stringList.removeAt(position);
  16.     }
  17.     endRemoveRows();
  18. }

接下来可以调用一下测试

  1.     model.insertRows(3,2);
  2.     model.removeRows(0,1);

运行的效果如下
https://cdn.llfc.club/1671256097654.jpg

源码链接

源码链接
https://gitee.com/secondtonone1/qt-learning-notes

热门评论
点击查看更多评论 没有更多评论了,点击收起 展开评论

热门文章

  1. 解密定时器的实现细节
    喜欢(566) 浏览(1796)

  2. C++ 类的继承封装和多态
    喜欢(588) 浏览(2504)

  3. slice介绍和使用
    喜欢(521) 浏览(1670)

  4. Linux环境搭建和编码
    喜欢(594) 浏览(5366)

  5. windows环境搭建和vscode配置
    喜欢(587) 浏览(1696)

最新评论

  1. 泛型算法的定制操作 secondtonone1:lambda和bind是C11新增的利器，善于利用这两个机制可以极大地提升编程安全性和效率。
  2. 基于锁实现线程安全队列和栈容器 secondtonone1:我是博主，你认真学习的样子的很可爱，哈哈，我画的是链表由空变成1个的情况。其余情况和你思考的类似，只不过我用了一个无效节点表示tail的指向，最初head和tail指向的都是这个节点。
  3. 解决博客回复区被脚本注入的问题 secondtonone1:走到现在我忽然明白一个道理，无论工作也好生活也罢，最重要的是开心，即使一份安稳的工作不能给我带来事业上的积累也要合理的舍弃，所以我还是想去做喜欢的方向。
  4. 利用内存模型优化无锁栈 卡西莫多的礼物:感谢博主指点，好人一生平安o(*￣▽￣*)ブ
  5. 类和对象 陈宇航:支持！！！！

其他链接

  1. GitHub
  2. 个人博客
  3. 博客园
  4. CSDN

个人公众号

个人微信