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，可以参考一下