淺析在QtWidget中自定義Model
Qt 4推出了一組新的item view類,它們使用model/view結(jié)構(gòu)來管理數(shù)據(jù)與表示層的關(guān)系。這種結(jié)構(gòu)帶來的功能上的分離給了開發(fā)人員更大的彈性來定制數(shù)據(jù)項(xiàng)的表示,它也提供一個(gè)標(biāo)準(zhǔn)的model接口,使得更多的數(shù)據(jù)源可以被這些item view使用。這里對(duì)model/view的結(jié)構(gòu)進(jìn)行了描述,結(jié)構(gòu)中的每個(gè)組件都進(jìn)行了解釋.。
一直覺得Qt里的Model-View概念極其神秘, 因?yàn)榭催^很多一知半解的source code, 卻總是咋看咋不懂,急了滿頭大汗之余不禁感嘆 — 老了,腦子不夠用了!
這兩天因?yàn)樵趯憆ssreader的關(guān)系,用到了MVC, 總算有點(diǎn)壓力學(xué)習(xí)學(xué)習(xí)ModelView的奧秘,而且也小有收獲。 謹(jǐn)以此文獻(xiàn)給MVC未入門的學(xué)弟學(xué)妹, 共勉!
先來講一些必備的背景知識(shí)。 在講MVC時(shí)有三個(gè)重要且基本的概念貫穿整個(gè)學(xué)習(xí)過程:Index, Data和Role。 就從Index開始。
我們見過的View有單列的List結(jié)構(gòu), 有樹狀的層次結(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è)定式, 通過一個(gè)父節(jié)點(diǎn)及一組橫縱座標(biāo)(row,column)即可唯一的確定一個(gè)子節(jié)點(diǎn), 這個(gè)規(guī)律在后面會(huì)經(jīng)常用到。Index可以簡單的理解成節(jié)點(diǎn)的指針, 前面說過通過三個(gè)要素即可唯一的確定一個(gè)節(jié)點(diǎn), 所以Model提供的獲得節(jié)點(diǎn)index函數(shù)亦即接受row,column和parentindex三個(gè)參數(shù), 我們?cè)趯憁odel時(shí)首先需要實(shí)現(xiàn)這樣一個(gè)函數(shù);
第二個(gè)概念Data就更簡單了,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就用來表示View向Model索取哪個(gè)類型的數(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, 其他的參見文檔DisplayRole相關(guān)章節(jié)):
作為Model必須決定為View提供多少數(shù)據(jù),提供哪些類型的數(shù)據(jù), 可以去滿足View的請(qǐng)求,也可以忽略它, 有很大的自主權(quán)。 最簡單的實(shí)現(xiàn)是不管什么Role都給它返回個(gè)字符串就好了。呵呵。 當(dāng)然作為Model也不能太獨(dú)斷專行,因?yàn)楫吘挂蚔iew一起工作, 一定要與View的需求相配合才行。
好, 有了這些知識(shí)做基礎(chǔ), 寫個(gè)Model出來其實(shí)是非常簡單的, 稍微用點(diǎn)心就能應(yīng)付了, 首先要選對(duì)參考文檔, 如果是以寫代碼為目的, 推薦這一篇:
Creating New Models
要寫code的話這篇最實(shí)用, 前面的N多篇都在講一些概念性的內(nèi)容, 大把大把的螞蟻樣的英文看了就頭大, 還是直接看這篇比較有效。 簡單來說分成幾步來做:
第一、分析需求,確定基類
先要確定你的數(shù)據(jù)是列表結(jié)構(gòu)還是層次結(jié)構(gòu), 需要顯示什么樣的數(shù)據(jù), 需不需要支持增刪或編輯功能等。 根據(jù)需求來確定從哪個(gè)Model的基類派生,如一個(gè)顯示字符串列表的Model可以采用QAbstractListModel, 樹狀層次就只能從QAbstractItemModel開始了。
第二、分析需求,確定需要實(shí)現(xiàn)哪些函數(shù)
根據(jù)需求的不同,需要實(shí)現(xiàn)的函數(shù)也不盡相同。
最簡單的只讀的列表結(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è)是通過父指針和row,column座標(biāo)確定一個(gè)子節(jié)點(diǎn),一個(gè)是通過子節(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ò)。 文檔里寫的是加數(shù)據(jù)的時(shí)候調(diào)用insertRows(),不過沒有提到說其實(shí)在QAbstractItemModel類里這個(gè)函數(shù)只是個(gè)空架子,根本就沒有實(shí)現(xiàn), 所以你如果按照文檔去調(diào)用這個(gè)函數(shù)通知Model數(shù)據(jù)加進(jìn)來了,只能得到一個(gè)return false, 不會(huì)有任何實(shí)際的作用, 很讓人困惑。 正確的做法是在你增刪數(shù)據(jù)的前后加上beginInsertRows和endInsertRows的調(diào)用,這樣底層就能正確處理數(shù)據(jù)的變化, 并且將變化及時(shí)的反應(yīng)到View中。
上面提到的函數(shù)在Creating New Models這篇文章中都有具體的例子代碼可供參考,相信照著例子做一定難不倒大家。 btw,實(shí)現(xiàn)函數(shù)的時(shí)候要注意, 函數(shù)的聲明必須和文檔中所描述的一模一樣才能被調(diào)到, 這也是初學(xué)者經(jīng)常不注意的地方。
小結(jié):QtWidget中自定義Model的內(nèi)容介紹完了,希望本篇對(duì)你有幫助。Model與數(shù)據(jù)源通訊,并提供接口給結(jié)構(gòu)中的別的組件使用。通訊的性質(zhì)依賴于數(shù)據(jù)源的種類
與model實(shí)現(xiàn)的方式。