C++ Qt怎么在QListWidget中实现项的拖拽排序-C++-PHP中文网

QListWidget实现拖拽排序需设setDragDropMode(QAbstractItemView::InternalMove)、setSelectionMode(SingleSelection)并重写dropEvent；Qt6中internalMove信号已废弃，应监听model()->rowsMoved()。

c++ qt怎么在qlistwidget中实现项的拖拽排序

QListWidget 默认不支持拖拽排序，必须手动启用

Qt 的 QListWidget 默认禁用拖拽功能，即使设置了 setDragEnabled(true) 和 setAcceptDrops(true)，也仅支持拖入外部数据（如文件路径），**不会自动重排内部 item**。真正实现“拖拽项来改变顺序”，需要同时开启拖拽、接受、重排三类行为，并重写关键事件处理逻辑。

必须调用 setDragDropMode(QAbstractItemView::InternalMove) —— 这是核心开关，仅设 DragOnly 或 DragDrop 都不行
setDragEnabled(true) 和 setAcceptDrops(true) 是必要但不充分条件
如果还设置了 setDropIndicatorShown(true)，会看到插入线提示，但不影响逻辑

为什么 setDragDropMode(InternalMove) 后仍无法排序？检查 selectionMode

常见现象：拖动 item 时光标变成禁止符号（?），松手后无反应。大概率是 selectionMode() 不匹配。Qt 要求在 InternalMove 模式下，**必须使用单选模式（SingleSelection）或扩展多选（ExtendedSelection）**，而 NoSelection 或 ContiguousSelection 会导致拖拽被拒绝。

推荐设为 setSelectionMode(QAbstractItemView::SingleSelection)（最稳妥）
若需多选拖拽（如一次拖多个 item 改变相对位置），则用 ExtendedSelection，但注意 Qt 默认只允许拖拽**当前选中项集合**，且目标位置插入的是整个选中块
别用 ContiguousSelection —— 它要求选区连续，但拖拽过程中选区可能被临时破坏，触发校验失败

拖拽过程中 item 消失或位置错乱？重写 dropEvent 是关键

即使启用了 InternalMove，某些 Qt 版本（尤其是 5.15+ / 6.x）在跨区域拖拽或快速操作时，QListWidget 的默认 dropEvent 可能误删 item 或插入到错误索引。稳妥做法是**拦截并重写 dropEvent，手动计算插入位置并移动 item**。

C++14

C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。

下载

在子类中重写：

void MyListWidget::dropEvent(QDropEvent *event) {
    if (event->source() == this && event->mimeData()->hasFormat("application/x-qabstractitemmodeldatalist")) {
        event->accept();
        QPoint pos = event->pos();
        int row = indexAt(pos).row();
        if (row == -1) row = count(); // 拖到末尾
        // 获取当前选中项（按原始顺序）
        auto items = selectedItems();
        // 从后往前移，避免索引偏移
        for (int i = items.size() - 1; i >= 0; --i) {
            QListWidgetItem *item = items[i];
            takeItem(row(item));
            if (row > row(item)) row--; // 原位置在目标前，插入点前移
            insertItem(row, item);
        }
    } else {
        QListWidget::dropEvent(event); // 兜底给父类处理外部数据
    }
}

注意：row(item) 返回的是 item 当前所在行号，必须在 takeItem() 前调用
从后往前遍历 items 是为了避免多次 takeItem() 导致后续 row(item) 失效

Qt 6 中的兼容性坑：QListWidget::internalMove 信号已废弃

Qt 5.12 引入了 internalMove 信号用于监听内部移动，但在 Qt 6.0+ 中该信号已被移除。如果你的代码里有连接这个信号做后续处理（比如保存顺序），现在必须改用 itemChanged 或监听 model()->rowsMoved() —— 但后者需获取底层 QStandardItemModel 实例（QListWidget 内部使用它）。

Qt 6 推荐方式：

connect(model(), &QAbstractItemModel::rowsMoved, this, [=](const QModelIndex &parent, int start, int end, const QModelIndex &dest, int row) {
    // 注意：start/end 是原范围，row 是新起始行；parent 和 dest 通常为空
});