Qt:在TreeModel+QTreeView中使用複選框(checkbox)

需要實作一個功能：在QT的TreeView中，能夠使用複選框，并且選中父節點的複選框可以全選或取消子節點的複選框。這裡就以QT附帶的simpletreemodel項目為例，說明一下其用法。simpletreemodel項目的路徑通常在qt目錄的example目錄的itemviews目錄下，例如，我的就在C:/Qt/2010.05/qt/examples/itemviews裡。

1.在頭檔案treemodel.h中，需要增加頭檔案

#include <QList>

#include <QPersistentModelIndex>

然後在treemodel類的定義中，加入setdata函數和m_checkedList變量的定義

1. public:  
2.     bool setData( const QModelIndex & index, const QVariant & value, int role = Qt::EditRole );  
3.     QList<QPersistentModelIndex> m_checkedList;  

其中，setData是treemodel類的父類QAbstractItemModel 中定義的一個函數，它的功能是響應滑鼠點選結點的動作。

m_checkedList則是用來儲存被選中(複選框内打勾)的結點的資訊

2.在到treemodel.cpp檔案中修改。主要是修改flags()、data()兩個函數，并實作setData()函數。

flags()函數修改為：

1. Qt::ItemFlags TreeModel::flags(const QModelIndex &index) const  
2. {  
3.     if (!index.isValid())  
4.         return 0;  
5.     if (index.column()==0)   //如果是第一列的結點，則使其有顯示checkbox的能力  
6.         return Qt::ItemIsEnabled | Qt::ItemIsSelectable | Qt::ItemIsUserCheckable;  
7.     return Qt::ItemIsEnabled | Qt::ItemIsSelectable;  
8. }  

主要修改的是，當判斷出結點的位置位于第一列，則增加Qt :: ItemIsUserCheckable ，使其具備顯示checkbox的能力

然後再修改data()函數：

1. QVariant TreeModel::data(const QModelIndex &index, int role) const  
2. {  
3.     if (!index.isValid())  
4.         return QVariant();  
5.     if (role==Qt::CheckStateRole && index.column()==0) //判斷顯示的對象是checkbox，并且位于第一列  
6.     {  
7.         if (m_checkedList.contains(index))    //在m_checkedList中查找，如果有，顯示checkbox被選中  
8.             return Qt::Checked;  
9.         else  
10.             return Qt::Unchecked;             //如果沒有顯示checkbox沒被選中  
11.     }  
12.     if (role != Qt::DisplayRole)  
13.         return QVariant();  
14.     TreeItem *item = static_cast<TreeItem*>(index.internalPointer());  
15.     return item->data(index.column());  
16. }  

最後是實作setData()函數，這個相對來說複雜一些

1. bool TreeModel::setData(const QModelIndex &index, const QVariant &value, int role)  
2. {  
3.     if (role==Qt::CheckStateRole && index.column()==0)  
4.     {  
5.         if (value==Qt::Unchecked)  
6.         {  
7.             m_checkedList.removeOne(index);  
8.             emit(dataChanged(index, index));  
9.         }  
10.         else if(value==Qt::Checked)  
11.         {  
12.             m_checkedList.append(index);  
13.             emit(dataChanged(index, index));  
14.         }  
15.         int childCount = rowCount();  
16.         if (childCount>0)                    //判斷是否有子節點  
17.         {  
18.             for (int i=0;i<childCount;i++)  
19.             {  
20.                QModelIndex child = this->index(i, 0, index); //獲得子節點的index  
21.                setData(child, value, Qt::CheckStateRole);    //遞歸，将子節點的checkbox設為選中狀态  
22.             }  
23.         }  
24.     }  
25. }  

主要是判斷對checkbox的操作是選中，還是反選中。如果是選中則将該結點的index加入m_checkedList中，并發送dataChanged信号。反之則将該節點的index從m_checkedList中删除，也發送dataChanged信号。dataChanged信号會觸發相應的槽函數，并且會調用到data()函數，這樣會重新加載這個結點的狀态

參考：rex237專欄的http://blog.csdn.net/Rex237/archive/2010/09/09/5873492.aspx

另外，在http://www.qtcn.org/bbs/read.php?tid=28120

有人提到了可以用QStandardItem來實作TreeView中使用checkbox，可以參考一下