Qt MVC结构之Model模型介绍

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());
  7. QTreeView * tree = new QTreeView(splitter);
  8. tree->setModel(model);
  9. tree->setRootIndex(model->index(QDir::currentPath()));
  10. QListView * list = new QListView(splitter);
  11. list->setModel(model);
  12. list->setRootIndex(model->index(QDir::currentPath()));
  13. splitter->setWindowTitle("Two views onto the same file system model");
  14. splitter->resize(1000,800);
  15. splitter->show();
  16. return a.exec();
  17. }

为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;
  18. QStandardItem * item1 = new QStandardItem();
  19. item1->setText("item1");
  20. QPixmap pixmap1(50,50);
  21. pixmap1.fill(Qt::blue);
  22. item1->setIcon(pixmap1);
  23. item1->setToolTip("indexB");
  24. parentItem->appendRow(item1);
  25. QStandardItem * item2 = new QStandardItem();
  26. item2->setData("item2",Qt::EditRole);
  27. QPixmap pixmap2(50,50);
  28. pixmap2.fill(Qt::green);
  29. item2->setData(QIcon(pixmap2), Qt::DecorationRole);
  30. item2->setData("indexC",Qt::ToolTipRole);
  31. parentItem->appendRow(item2);
  32. //取出根节点第0行0列的模型索引
  33. QModelIndex indexA = model.index(0,0, QModelIndex());
  34. qDebug() << "model indexA row count is " << model.rowCount(indexA);
  35. //获取indexA节点下0行0列
  36. QModelIndex indexB = model.index(0,0,indexA);
  37. qDebug() << "indexB text is " << model.data(indexB,Qt::EditRole).toString();
  38. qDebug() << "indexB icon is " << model.data(indexB,Qt::DecorationRole);
  39. qDebug() << "indexB tool tip is " << model.data(indexB,Qt::ToolTipRole).toString();
  40. QTreeView view;
  41. view.setModel(&model);
  42. view.show();
  43. return a.exec();
  44. }

运行后程序效果图
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. {
  5. }
  6. int StringListModel::rowCount(const QModelIndex& parent ) const{
  7. return stringList.count();
  8. }
  9. QVariant StringListModel::data(const QModelIndex& index, int role) const{
  10. if(!index.isValid()){
  11. return QVariant();
  12. }
  13. if(index.row() >= stringList.size()){
  14. return QVariant();
  15. }
  16. if(role == Qt::DisplayRole){
  17. return stringList.at(index.row());
  18. }else{
  19. return QVariant();
  20. }
  21. }
  22. QVariant StringListModel::headerData(int section, Qt::Orientation orientation,
  23. int role ) const{
  24. if(role != Qt::DisplayRole){
  25. return QVariant();
  26. }
  27. if(orientation == Qt::Horizontal){
  28. return QString("Column %1").arg(section);
  29. }else{
  30. return QString("Row %1").arg(section);
  31. }
  32. }

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";
  6. StringListModel model(list);
  7. QListView listView;
  8. listView.setModel(&model);
  9. listView.show();
  10. QTableView tableView;
  11. tableView.setModel(&model);
  12. tableView.show();
  13. return a.exec();
  14. }

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. }
  5. if(index.row() >= stringList.size()){
  6. return QVariant();
  7. }
  8. if(role == Qt::DisplayRole || role == Qt::EditRole){
  9. return stringList.at(index.row());
  10. }else{
  11. return QVariant();
  12. }
  13. }

添加行与删除行

添加行和删除行都需要在添加和删除之前调用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. }
  10. bool StringListModel::removeRows(int position, int rows,
  11. const QModelIndex & index ){
  12. beginRemoveRows(QModelIndex(), position, position+ rows-1);
  13. for(int row=0; row < rows; ++ row){
  14. stringList.removeAt(position);
  15. }
  16. endRemoveRows();
  17. }

接下来可以调用一下测试

  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) 浏览(1144)
  2. C++ 类的继承封装和多态

    喜欢(588) 浏览(1285)
  3. Linux环境搭建和编码

    喜欢(594) 浏览(2067)
  4. windows环境搭建和vscode配置

    喜欢(587) 浏览(1294)
  5. slice介绍和使用

    喜欢(521) 浏览(1300)

最新评论

  1. golang 函数介绍 secondtonone1:函数是go中的一等公民,作为新兴语言,go摒弃了面向对象的一些糟粕,采取接口方式编程,而接口方式编程都是基于函数的,参数为interface,进而达到泛型作用,比如sort排序,只需要传入的参数满足sort所需interface的规定即可,需实现Len, Swap, Less三个方法,只要实现了这三个方法都可以用来做sort排序的参数。
  2. 解决博客回复区被脚本注入的问题 secondtonone1:走到现在我忽然明白一个道理,无论工作也好生活也罢,最重要的是开心,即使一份安稳的工作不能给我带来事业上的积累也要合理的舍弃,所以我还是想去做喜欢的方向。
  3. Linux环境搭建和编码 恋恋风辰:Linux环境下go的安装比较简单,可以不用设置GOPATH环境变量,后期我们学习go mod 之后就拜托了go文件目录的限制了。
  4. 双链表实现LRU算法 secondtonone1:双链表插入和删除节点是本篇的难点,多多练习即可。
  5. C++ 类的拷贝构造、赋值运算、单例模式 secondtonone1:本文实现了线程安全的单例模式,介绍了拷贝构造和拷贝赋值的区别和联系,以及如何构造单例类,对于通用单例类如何构造可以使用模板,这个之后的章节回来介绍

个人公众号

个人微博