QTreeView/QTableView中利用QStandardItem实现复选框三种形态变化

博客地址已更改，文章数量较多不便批量修改，若想访问源文请到 coologic博客 查阅，网址：www.coologic.cn

如本文记录地址为 techieliang.com/A/B/C/ 请改为 www.coologic.cn/A/B/C/ 即可查阅

 

版权声明：若无来源注明，Techie亮博客文章均为原创。 转载请以链接形式标明本文标题和地址：
本文标题：QTreeView/QTableView中利用QStandardItem实现复选框三种形态变化     本文地址：http://techieliang.com/2017/12/729/

1. 介绍

复选框有三种形态：全选对勾、全不选空白、半选黑点

在item中通过：setCheckable(true);可开启复选框功能，但默认只支持全选对勾、全不选空白，而且自身的状态变动不会使父/子节点相应，比如子节点全部选中时父节点不会自动勾选

下面你提供一个完整的UsingCheckboxItem类，此类继承自QStandardItem，实现了复选框三种状态的使用。类内容很纯粹并未增加其他设置，仅为复选框实现。

注意，此方式让一个item调用了其父节点及子节点的data和setdata两个方法，若不符合设计要求，可仿照此方式在model中重现

下面直接上源码：

2. 源码

2.1. using_checkbox_item.h

  1. /**
  2. * @file using_checkbox_item.h
  3. * @brief 本文件包含支持复选框item类声明。
  4. * @version 1.0.0.0
  5. * @date 2017.12.18
  6. * @author Techie亮
  7. */
  8. #ifndef _H_USINGCHECKBOXITEM_
  9. #define _H_USINGCHECKBOXITEM_
  10. #include <QStandardItem>
  11. #include <QString>
  12. /**
  13. * @brief 支持复选框item类
  14. * 支持复选框三态转变-全选对勾、全不选空白、半选黑点
  15. * 子类会自动通知父子节点item，若不符合设计需要可仿照此方式在model中的setDate重现
  16. */
  17. class UsingCheckboxItem : public QStandardItem {
  18. public:
  19. /**
  20. * @brief 构造函数
  21. * @param item显示内容
  22. */
  23. explicit UsingCheckboxItem(const QString &text);
  24. /**
  25. * @brief setData重写
  26. * @param value data值
  27. * @param role data类型
  28. */
  29. virtual void setData(const QVariant &value, int role = Qt::UserRole + 1);
  30. };
  31. #endif // _H_USINGCHECKBOXITEM_

2.2. using_checkbox_item.cpp

  1. #include "using_checkbox_item.h"
  2. //构造函数
  3. UsingCheckboxItem::UsingCheckboxItem(const QString &text)
  4. : QStandardItem(text) {
  5. setCheckable(true);
  6. }
  7. //setData重写
  8. void UsingCheckboxItem::setData(const QVariant &value, int role) {
  9. if(role == Qt::CheckStateRole) {//针对复选框变动做操作
  10. Qt::CheckState check_state = (Qt::CheckState)value.toInt();
  11. QString mtext=text();
  12. switch (check_state) {
  13. case Qt::Unchecked: {//取消
  14. for(int i = 0, num = rowCount(); i < num; i++) {
  15. child(i)->setData(Qt::Unchecked, Qt::CheckStateRole);
  16. }
  17. //修改内容-必须先修改自己再通知父节点
  18. QStandardItem::setData(value,role);
  19. //通知父节点，我取消了选择，直接告诉父节点半选即可
  20. if(parent())parent()->setData(Qt::PartiallyChecked, role);
  21. }
  22. return;//此事件已完成直接return
  23. case Qt::PartiallyChecked: {//半选
  24. Qt::CheckState current_state = checkState();//当前状态
  25. int checked_num = 0;//被选择的数量
  26. int unchecked_num = 0;//未选择的数量
  27. bool is_partially = false;
  28. Qt::CheckState child_state;
  29. int m_rowCount = rowCount();
  30. //遍历所有子节点
  31. for(int i = 0; i < m_rowCount; i++) {
  32. child_state = child(i)->checkState();
  33. //子节点半选，则直接半选
  34. switch (child_state) {
  35. case Qt::PartiallyChecked:is_partially = true;break;
  36. case Qt::Unchecked:unchecked_num++;break;
  37. case Qt::Checked:checked_num++;break;
  38. default:checked_num++;break;
  39. }
  40. }
  41. //根据子节点状态确定当前节点应该设置的状态
  42. Qt::CheckState now_state;
  43. if(is_partially)
  44. now_state = Qt::PartiallyChecked;
  45. else if(checked_num == m_rowCount)
  46. now_state = Qt::Checked;
  47. else if(unchecked_num == m_rowCount)
  48. now_state = Qt::Unchecked;
  49. else
  50. now_state = Qt::PartiallyChecked;
  51. //修改状态并通知父节点
  52. if(current_state != now_state) {
  53. //修改内容-必须先修改自己再通知父节点
  54. QStandardItem::setData(now_state,role);
  55. //通知父节点，我的状态更改,也就是父节点进入半选
  56. if(parent())parent()->setData(Qt::PartiallyChecked, role);
  57. }
  58. }
  59. return;//此事件已完成直接return
  60. case Qt::Checked: {//全选
  61. for(int i = 0, num = rowCount(); i < num; i++) {
  62. child(i)->setData(Qt::Checked, Qt::CheckStateRole);
  63. }
  64. //修改内容-必须先修改自己再通知父节点
  65. QStandardItem::setData(value,role);
  66. //通知父节点，我被选了,也就是父节点进入半选
  67. if(parent()) {
  68. parent()->setData(Qt::PartiallyChecked, role);
  69. }
  70. }
  71. return;//此事件已完成直接return
  72. default://如果出现此情况就是错了，可以加错误处理
  73. break;
  74. }
  75. }
  76. QStandardItem::setData(value,role);
  77. }

3. 说明

  • 重写了setData方法，但仅对CheckStateRole类型data做了操作，其余类型通过最后的QStandardItem::setData(value,role)直接使用默认方式
  • setData中每个case后均直接return，因为会根据value和父子类情况对实际要使用value做修改，最终赋值给QStandardItem::setData不一定是参数value，所以若不返回，必然会调用最后一样导致出错
  • 系统默认只有两个状态切换选中和补选中，所以可以借用这个特性，当一个节点状态修改时都通知其父类为PartiallyChecked部分选中状态，由父节点自行判断子节点情况并设置自身状态
  • 注意一定要先修改自身状态以后在通知父节点，否则在父节点函数运行过程中自身仍为未修改状态，会导致判断错误
  • 在PartiallyChecked的case中判断了一下新旧状态是否改变，若改变会向上一父节点继续传递消息，不改变则立刻停止减少运算量
  • 若子节点存在PartiallyChecked状态的，则当前节点一定为PartiallyChecked
  • 注意最顶级item是没有parent的所以想父节点传递消息前一定要判断parent是否为nullptr
  • 选择一个节点那么此节点一定会在全选-不选两个状态切换，而部分选择仅存在于此节点的子节点发生变动，所以全选-不选两个case直接对所有子节点赋值
转载请以链接形式标明本文标题和地址：Techie亮博客 » QTreeView/QTableView中利用QStandardItem实现复选框三种形态变化
posted @ 2017-12-18 18:20  Coologic  阅读(5858)  评论(0)  编辑  收藏  举报