在QtWidget中自定義Model
本篇介紹的是在Qt Widget中自定義Model 的內(nèi)容，一直覺(jué)得Qt里的Model-View概念極其神秘， 因?yàn)榭催^(guò)很多一知半解的source code。
這兩天因?yàn)樵趯?xiě)rssreader的關(guān)系，用到了MVC，總算有點(diǎn)壓力學(xué)習(xí)學(xué)習(xí)ModelView的奧秘，而且也小有收獲。 謹(jǐn)以此文獻(xiàn)給MVC未入門(mén)的學(xué)弟學(xué)妹， 共勉！
先來(lái)講一些必備的背景知識(shí)。在講MVC時(shí)有三個(gè)重要且基本的概念貫穿整個(gè)學(xué)習(xí)過(guò)程：Index， Data和Role。 就從Index開(kāi)始。
我們見(jiàn)過(guò)的View有單列的List結(jié)構(gòu)， 有樹(shù)狀的層次結(jié)構(gòu)，還有兩維的表格結(jié)構(gòu)， 歸根結(jié)底，其實(shí)這些都是層次結(jié)構(gòu)的變體。 比如下面的圖：
從這張圖可以清楚的理解上文的觀點(diǎn)。 在這幾種結(jié)構(gòu)中，都有一個(gè)隱含的根節(jié)點(diǎn)及與根節(jié)點(diǎn)聯(lián)系的層次結(jié)構(gòu)。 任何一種結(jié)構(gòu)中都存在這樣一個(gè)定式， 通過(guò)一個(gè)父節(jié)點(diǎn)及一組橫縱座標(biāo)（row,column)即可唯一的確定一個(gè)子節(jié)點(diǎn)， 這個(gè)規(guī)律在后面會(huì)經(jīng)常用到。Index可以簡(jiǎn)單的理解成節(jié)點(diǎn)的指針， 前面說(shuō)過(guò)通過(guò)三個(gè)要素即可唯一的確定一個(gè)節(jié)點(diǎn)， 所以Model提供的獲得節(jié)點(diǎn)index函數(shù)亦即接受row，column和parentindex三個(gè)參數(shù)， 我們?cè)趯?xiě)model時(shí)首先需要實(shí)現(xiàn)這樣一個(gè)函數(shù)；
第二個(gè)概念Data就更簡(jiǎn)單了，View要顯示數(shù)據(jù)， 就要從Model中去獲取需要顯示的數(shù)據(jù)， 傳什么參數(shù)呢？ 不用動(dòng)腦子也想的到咯，Index肯定算一個(gè)。 但僅僅Index并不夠， 因?yàn)閂iew要顯示的可能不止一項(xiàng)數(shù)據(jù)，比如我的數(shù)據(jù)包含文本， 包含圖標(biāo)，包含鏈接甚至一些二進(jìn)制數(shù)據(jù)， 我怎么知道View想要的是哪個(gè)呢？ 這里就用到另外一個(gè)概念了 — Role， Role就用來(lái)表示View向Model索取哪個(gè)類(lèi)型的數(shù)據(jù)。 View告訴Model：“我想要A節(jié)點(diǎn)下的N行M列數(shù)據(jù)的顯示文本； 我想要A節(jié)點(diǎn)下的N行M列數(shù)據(jù)的圖標(biāo)…”， 這樣Model就清楚的知道應(yīng)該返回什么數(shù)據(jù)了。 data()函數(shù)在這里就充當(dāng)了返回?cái)?shù)據(jù)的責(zé)任，需要我們?cè)趯?shí)現(xiàn)Model的時(shí)候重點(diǎn)實(shí)現(xiàn)這個(gè)函數(shù)。
目前定義好的Role可以參考下面的圖（圖中只標(biāo)出了一部分Role， 其他的參見(jiàn)文檔DisplayRole相關(guān)章節(jié)）：
作為Model必須決定為View提供多少數(shù)據(jù)，提供哪些類(lèi)型的數(shù)據(jù)， 可以去滿(mǎn)足View的請(qǐng)求，也可以忽略它， 有很大的自主權(quán)。 最簡(jiǎn)單的實(shí)現(xiàn)是不管什么Role都給它返回個(gè)字符串就好了。呵呵。 當(dāng)然作為Model也不能太獨(dú)斷專(zhuān)行，因?yàn)楫吘挂蚔iew一起工作， 一定要與View的需求相配合才行。
好，有了這些知識(shí)做基礎(chǔ)， 寫(xiě)個(gè)Model出來(lái)其實(shí)是非常簡(jiǎn)單的， 稍微用點(diǎn)心就能應(yīng)付了， 首先要選對(duì)參考文檔， 如果是以寫(xiě)代碼為目的， 推薦這一篇：
要寫(xiě)code的話這篇最實(shí)用， 前面的N多篇都在講一些概念性的內(nèi)容， 大把大把的螞蟻樣的英文看了就頭大， 還是直接看這篇比較有效。 簡(jiǎn)單來(lái)說(shuō)分成幾步來(lái)做：
一、分析需求，確定基類(lèi)
先要確定你的數(shù)據(jù)是列表結(jié)構(gòu)還是層次結(jié)構(gòu)， 需要顯示什么樣的數(shù)據(jù)， 需不需要支持增刪或編輯功能等。 根據(jù)需求來(lái)確定從哪個(gè)Model的基類(lèi)派生，如一個(gè)顯示字符串列表的Model可以采用QAbstractListModel， 樹(shù)狀層次就只能從QAbstractItemModel開(kāi)始了。
二、分析需求，確定需要實(shí)現(xiàn)哪些函數(shù)
根據(jù)需求的不同，需要實(shí)現(xiàn)的函數(shù)也不盡相同。
最簡(jiǎn)單的只讀的列表結(jié)構(gòu)只需要實(shí)現(xiàn)兩個(gè)基本的函數(shù)：rowCount(), data()， 也就是只需要知道一共有多少行，每行都顯示什么樣的數(shù)據(jù)即可， 十分明了吧？ 多列的情況下要實(shí)現(xiàn)columnCount()， 需要顯示header的要去實(shí)現(xiàn)headerData()， 這些規(guī)則都太容易理解了。
其次，如果是層次列表，則需要確定節(jié)點(diǎn)之間的層次關(guān)系，就需要實(shí)現(xiàn)index()和parent()兩個(gè)函數(shù)， 一個(gè)是通過(guò)父指針和row,column座標(biāo)確定一個(gè)子節(jié)點(diǎn)，一個(gè)是通過(guò)子節(jié)點(diǎn)知道它的父指針。
再次，如果需要修改數(shù)據(jù)， 先要通知View我的Model數(shù)據(jù)是可以被編輯的， 就是要實(shí)現(xiàn)flags()這個(gè)函數(shù)， 此函數(shù)返回?cái)?shù)據(jù)的屬性，如可編輯、可被選中等； 編輯之后需要一個(gè)函數(shù)將編輯完成的數(shù)據(jù)傳遞給Model， 所以還要實(shí)現(xiàn)一個(gè)setData方法。
再再次， 需要增刪數(shù)據(jù)的Model還要告訴Model的底層：“我要增刪數(shù)據(jù)了！”， “我要增刪的數(shù)據(jù)是。。。”， 還有“我增刪的操作已經(jīng)做完了！”， 這些分別對(duì)應(yīng)：調(diào)用beginInsertRows()和endInsertRows()。 根據(jù)筆者的經(jīng)驗(yàn)，這部分不太好理解，而且容易出錯(cuò)。 文檔里寫(xiě)的是加數(shù)據(jù)的時(shí)候調(diào)用insertRows()，不過(guò)沒(méi)有提到說(shuō)其實(shí)在QAbstractItemModel類(lèi)里這個(gè)函數(shù)只是個(gè)空架子，根本就沒(méi)有實(shí)現(xiàn)， 所以你如果按照文檔去調(diào)用這個(gè)函數(shù)通知Model數(shù)據(jù)加進(jìn)來(lái)了，只能得到一個(gè)return false， 不會(huì)有任何實(shí)際的作用， 很讓人困惑。 正確的做法是在你增刪數(shù)據(jù)的前后加上beginInsertRows和endInsertRows的調(diào)用，這樣底層就能正確處理數(shù)據(jù)的變化， 并且將變化及時(shí)的反應(yīng)到View中。
小結(jié)：在Qt Widget中自定義Model 的內(nèi)容介紹完了，上面提到的函數(shù)在Creating New Models這篇文章中都有具體的例子代碼可供參考，相信照著例子做一定難不倒大家。 有用到以上函數(shù)的同志們，希望能幫你解決其中的問(wèn)題吧。
【編輯推薦】
