QTreeWidget拖拽移动子项消失问题求助：子项不可转为父项

数据老陈

2026-7-21

QTreeWidget拖拽子项消失问题排查与解决

核心排查方向与修复方案

拖拽后子项消失，基本和拖拽逻辑不严谨、目标节点判断错误、数据转移不完整有关，结合你“子项不能转为父项”的要求，按以下步骤排查：

确保仅允许拖到父项节点
拖拽时如果误将子项作为目标父节点，Qt默认逻辑会拒绝操作，导致子项丢失。在dropEvent里必须判断目标是顶级父项：

QTreeWidgetItem *targetItem = itemAt(event->pos());
if (!targetItem || targetItem->parent() != nullptr) {
    event->ignore(); // 非合法父项，直接忽略
    return;
}

正确处理MIME数据与拖拽动作
重写mimeTypes()和mimeData()时，只封装子项数据，且限制拖拽动作为移动：

QStringList CustomTreeWidget::mimeTypes() const {
    return {"application/x-qtreewidgetitem"};
}

QMimeData *CustomTreeWidget::mimeData(const QList<QTreeWidgetItem *> items) const {
    QMimeData *mime = new QMimeData();
    QByteArray data;
    QDataStream stream(&data, QIODevice::WriteOnly);
    for (auto item : items) {
        if (item->parent()) { // 只处理子项
            stream << item->text(0);
            // 可添加更多子项数据，比如其他列内容
        }
    }
    mime->setData("application/x-qtreewidgetitem", data);
    return mime;
}

同时设置拖拽模式为内部移动：

setDragDropMode(QAbstractItemView::InternalMove);
setDragEnabled(true);
setAcceptDrops(true);

完整执行子项移动逻辑
移动子项时必须先从原父项移除，再添加到新父项，避免索引混乱：

auto draggedItems = selectedItems();
for (auto item : draggedItems) {
    if (!item->parent()) continue; // 跳过父项
    auto oldParent = item->parent();
    oldParent->removeChild(item);
    targetItem->addChild(item); // targetItem是之前判断的合法父项
}
event->accept(); // 必须确认接受事件