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