QtWidget: 自定义Model

QtWidget: 自定义Model

一直觉得Qt里的Model-View概念极其神秘， 因为看过很多一知半解的source code， 却总是咋看咋不懂，急了满头大汗之余不禁感叹 — 老了，脑子不够用了！

这两天因为在写rssreader的关系，用到了MVC， 总算有点压力学习学习ModelView的奥秘，而且也小有收获。 谨以此文献给MVC未入门的学弟学妹， 共勉！

先来讲一些必备的背景知识。 在讲MVC时有三个重要且基本的概念贯穿整个学习过程：Index， Data和Role。 就从Index开始。

我们见过的View有单列的List结构， 有树状的层次结构，还有两维的表格结构， 归根结底，其实这些都是层次结构的变体。 比如下面的图：

从这张图可以清楚的理解上文的观点。 在这几种结构中，都有一个隐含的根节点及与根节点联系的层次结构。 任何一种结构中都存在这样一个定式， 通过一个父节点及一组横纵座标（row,column)即可唯一的确定一个子节点， 这个规律在后面会经常用到。Index可以简单的理解成节点的指针， 前面说过通过三个要素即可唯一的确定一个节点， 所以Model提供的获得节点index函数亦即接受row，column和parentindex三个参数， 我们在写model时首先需要实现这样一个函数；

第二个概念Data就更简单了，View要显示数据， 就要从Model中去获取需要显示的数据， 传什么参数呢？ 不用动脑子也想的到咯，Index肯定算一个。 但仅仅Index并不够， 因为View要显示的可能不止一项数据，比如我的数据包含文本， 包含图标，包含链接甚至一些二进制数据， 我怎么知道View想要的是哪个呢？ 这里就用到另外一个概念了 — Role， Role就用来表示View向Model索取哪个类型的数据。 View告诉Model：“我想要A节点下的N行M列数据的显示文本； 我想要A节点下的N行M列数据的图标…”， 这样Model就清楚的知道应该返回什么数据了。 data()函数在这里就充当了返回数据的责任，需要我们在实现Model的时候重点实现这个函数。

目前定义好的Role可以参考下面的图（图中只标出了一部分Role， 其他的参见文档DisplayRole相关章节）：

 

作为Model必须决定为View提供多少数据，提供哪些类型的数据， 可以去满足View的请求，也可以忽略它， 有很大的自主权。 最简单的实现是不管什么Role都给它返回个字符串就好了。呵呵。 当然作为Model也不能太独断专行，因为毕竟要和View一起工作， 一定要与View的需求相配合才行。

好， 有了这些知识做基础， 写个Model出来其实是非常简单的， 稍微用点心就能应付了， 首先要选对参考文档， 如果是以写代码为目的， 推荐这一篇：

Creating New Models

要写code的话这篇最实用， 前面的N多篇都在讲一些概念性的内容， 大把大把的蚂蚁样的英文看了就头大， 还是直接看这篇比较有效。 简单来说分成几步来做：

第一、分析需求，确定基类

先要确定你的数据是列表结构还是层次结构， 需要显示什么样的数据， 需不需要支持增删或编辑功能等。 根据需求来确定从哪个Model的基类派生，如一个显示字符串列表的Model可以采用QAbstractListModel， 树状层次就只能从QAbstractItemModel开始了。

第二、分析需求，确定需要实现哪些函数

根据需求的不同，需要实现的函数也不尽相同。 

最简单的只读的列表结构只需要实现两个基本的函数：rowCount(), data()， 也就是只需要知道一共有多少行，每行都显示什么样的数据即可， 十分明了吧？ 多列的情况下要实现columnCount()， 需要显示header的要去实现headerData()， 这些规则都太容易理解了。

其次，如果是层次列表，则需要确定节点之间的层次关系，就需要实现index()和parent()两个函数， 一个是通过父指针和row,column座标确定一个子节点，一个是通过子节点知道它的父指针。

再次，如果需要修改数据， 先要通知View我的Model数据是可以被编辑的， 就是要实现flags()这个函数， 此函数返回数据的属性，如可编辑、可被选中等； 编辑之后需要一个函数将编辑完成的数据传递给Model， 所以还要实现一个setData方法。

再再次， 需要增删数据的Model还要告诉Model的底层：“我要增删数据了！”， “我要增删的数据是。。。”， 还有“我增删的操作已经做完了！”， 这些分别对应：调用beginInsertRows()和endInsertRows()。 根据笔者的经验，这部分不太好理解，而且容易出错。 文档里写的是加数据的时候调用insertRows()，不过没有提到说其实在QAbstractItemModel类里这个函数只是个空架子，根本就没有实现， 所以你如果按照文档去调用这个函数通知Model数据加进来了，只能得到一个return false， 不会有任何实际的作用， 很让人困惑。 正确的做法是在你增删数据的前后加上beginInsertRows和endInsertRows的调用，这样底层就能正确处理数据的变化， 并且将变化及时的反应到View中。

 

上面提到的函数在Creating New Models这篇文章中都有具体的例子代码可供参考，相信照着例子做一定难不倒大家。 btw，实现函数的时候要注意， 函数的声明必须和文档中所描述的一模一样才能被调到， 这也是初学者经常不注意的地方。 在Qt文档中， 下一篇就该学习如何使用View和创建自己的View了，这部分还有待研究。 等研究好了再撰文汇报！

原文链接:http://www.cuteqt.com/blog/?p=218