QTreeWidget间拖拽实现及跨树拖拽后视图更新问题

需求概述 #

• Tree1：仅包含顶级元素，仅支持内部排序；元素拖拽至Tree2后，Tree1需移除该元素
• Tree2：可接收Tree1的元素，内部支持元素移动，同时可与新增的Tree3互相拖拽元素
• Tree3：与Tree2实现双向元素拖拽

遇到的问题 #

1. 重写QTreeWidget拖拽相关方法后，Tree1与Tree2之间的跨树拖拽事件未触发
2. 新增Tree3后，Tree2与Tree3之间跨树拖拽元素时，原树视图无法及时更新界面

解决方案 #

1. 解决跨树拖拽事件未触发的问题 #

• 正确设置拖拽模式：
  给三个Tree分别配置合适的拖拽模式，确保跨部件拖拽的权限：

  // Tree1仅允许拖拽出去
  tree1->setDragDropMode(QAbstractItemView::DragOnly);
  tree1->setSortingEnabled(true); // 开启内部排序
  
  // Tree2、Tree3允许拖拽和接收
  tree2->setDragDropMode(QAbstractItemView::DragDrop);
  tree2->setDefaultDropAction(Qt::MoveAction);
  tree3->setDragDropMode(QAbstractItemView::DragDrop);
  tree3->setDefaultDropAction(Qt::MoveAction);
  

• 重写拖拽方法时兼容跨部件场景：
  重写startDrag()时，不要自定义私有MIME类型，直接使用QTreeWidget内置的mimeData()方法生成标准MIME数据，确保其他Tree可以识别；重写dropEvent()时，先判断拖拽来源是否为外部Tree，再处理元素的移动逻辑：

  void MyTreeWidget::dropEvent(QDropEvent *event)
  {
      if (event->source() != this) {
          QTreeWidget *sourceTree = qobject_cast<QTreeWidget*>(event->source());
          if (!sourceTree) return;
  
          // 处理选中元素的移动
          QList<QTreeWidgetItem*> selectedItems = sourceTree->selectedItems();
          for (auto item : selectedItems) {
              // 复制元素到当前Tree（可根据需求调整为移动逻辑）
              QTreeWidgetItem *newItem = new QTreeWidgetItem(item->text(0));
              this->addTopLevelItem(newItem);
              // 移除原Tree的元素
              sourceTree->takeTopLevelItem(sourceTree->indexOfTopLevelItem(item));
          }
          event->acceptProposedAction();
      } else {
          // 内部拖拽沿用默认逻辑
          QTreeWidget::dropEvent(event);
      }
  }
  

2. 解决跨树拖拽后原树视图不更新的问题 #

通过监听内置信号+自定义信号的组合，强制触发视图刷新：

• 监听rowsRemoved信号：
  当Tree内元素被移除时，触发视图刷新：

  // 给Tree2、Tree3绑定刷新逻辑
  connect(tree2, &QTreeWidget::rowsRemoved, tree2, [=](const QModelIndex&, int, int){
      tree2->viewport()->update();
  });
  connect(tree3, &QTreeWidget::rowsRemoved, tree3, [=](const QModelIndex&, int, int){
      tree3->viewport()->update();
  });
  

• 自定义信号同步刷新：
  在跨Tree拖拽完成后，发送自定义信号通知原Tree执行刷新，确保界面及时更新：

  // 在自定义TreeWidget类中声明信号
  class MyTreeWidget : public QTreeWidget
  {
      Q_OBJECT
  signals:
      void dragCompleted();
  };
  
  // 在dropEvent中发送信号
  void MyTreeWidget::dropEvent(QDropEvent *event)
  {
      if (event->source() != this) {
          // ... 元素移动逻辑 ...
          emit dragCompleted();
          event->acceptProposedAction();
      } else {
          QTreeWidget::dropEvent(event);
      }
  }
  
  // 绑定信号到原Tree的刷新操作
  connect(tree2, &MyTreeWidget::dragCompleted, tree3, [=](){
      tree3->viewport()->update();
  });
  connect(tree3, &MyTreeWidget::dragCompleted, tree2, [=](){
      tree2->viewport()->update();
  });
  

内容的提问来源于stack exchange，提问作者user10539815