QListView(图标模式)拖拽排序：模型更新异常求助

问题原因分析 #

1. moveRows崩溃原因 #

重写moveRows时无报错崩溃，大概率是以下问题导致：

• beginMoveRows参数错误：图标模式下所有项的父索引都是空QModelIndex()，若传入非空父索引，或源/目标行号计算错误（比如拖拽目标位置未考虑数据移除后的偏移），会触发模型状态不一致。
• 操作顺序颠倒：必须先调用beginMoveRows通知视图即将修改，再调整模型内部数据结构，最后调用endMoveRows。如果先修改数据再调用begin方法，会直接导致模型与视图状态冲突崩溃。
• 边界情况未处理：比如拖拽到列表首尾时，目标行号判断错误，导致begin/end方法的参数不匹配。

2. dropMimeData未触发原因 #

该方法不执行，通常是配置缺失：

• ListView拖拽模式未设置：需将dragDropMode设为QListView::InternalMove，否则内部拖拽的drop逻辑不会被触发。
• 模型flags权限不足：flags()方法必须返回Qt::ItemIsDragEnabled | Qt::ItemIsDropEnabled | Qt::ItemIsSelectable，否则项不支持拖拽/放置操作。
• 未声明支持的Drop动作：重写supportedDropActions()返回Qt::MoveAction，明确告知模型支持移动操作。
• MIME类型不匹配：mimeTypes()需返回自定义的合法MIME类型（如application/vnd.listmodel.item），否则drop时无法识别拖拽数据。

正确实现方案 #

方案一：正确重写moveRows（推荐，符合Qt模型视图规范） #

核心是严格遵循Qt模型通知流程，确保参数与操作顺序无误。

示例代码（自定义ListModel）：

class CustomListModel : public QAbstractListModel
{
    Q_OBJECT
private:
    QList<QString> m_data; // 示例存储字符串数据
public:
    explicit CustomListModel(QObject *parent = nullptr) : QAbstractListModel(parent) {}

    int rowCount(const QModelIndex &parent = QModelIndex()) const override {
        return parent.isValid() ? 0 : m_data.size();
    }

    QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override {
        if (!index.isValid() || index.row() >= m_data.size()) return QVariant();
        if (role == Qt::DisplayRole || role == Qt::DecorationRole) {
            return m_data[index.row()];
        }
        return QVariant();
    }

    Qt::ItemFlags flags(const QModelIndex &index) const override {
        if (!index.isValid()) return Qt::ItemIsDropEnabled; // 空索引支持放置
        return Qt::ItemIsSelectable | Qt::ItemIsEnabled | Qt::ItemIsDragEnabled | Qt::ItemIsDropEnabled;
    }

    bool moveRows(const QModelIndex &sourceParent, int sourceRow, int count,
                  const QModelIndex &destinationParent, int destinationChild) override {
        // 图标模式下父索引必须为空，且只处理单条拖拽（多条可扩展）
        if (sourceParent.isValid() || destinationParent.isValid() || count != 1) return false;
        // 跳过无意义的移动（比如拖到自身位置）
        if (sourceRow == destinationChild || sourceRow == destinationChild - 1) return false;

        // 先通知视图即将移动数据
        beginMoveRows(sourceParent, sourceRow, sourceRow,
                      destinationParent, destinationChild);

        // 调整内部数据结构
        QString item = m_data.takeAt(sourceRow);
        // 处理数据移除后的目标位置偏移
        int insertPos = destinationChild > sourceRow ? destinationChild - 1 : destinationChild;
        m_data.insert(insertPos, item);

        // 通知视图移动完成
        endMoveRows();
        return true;
    }

    Qt::DropActions supportedDropActions() const override {
        return Qt::MoveAction;
    }
};

ListView配置代码：

QListView *listView = new QListView(this);
listView->setViewMode(QListView::IconMode);
listView->setDragDropMode(QListView::InternalMove);
listView->setDefaultDropAction(Qt::MoveAction);
listView->setModel(new CustomListModel(this));

方案二：实现dropMimeData + mimeData #

若不想使用moveRows，可通过MIME数据传递实现排序同步，核心是确保MIME类型匹配，正确处理拖拽源与目标位置。

在自定义模型中补充以下方法：

QMimeData *mimeData(const QModelIndexList &indexes) const override {
    QMimeData *mimeData = new QMimeData();
    if (!indexes.isEmpty()) {
        // 存储拖拽源的行号
        mimeData->setData("application/vnd.listmodel.item",
                          QByteArray::number(indexes.first().row()));
    }
    return mimeData;
}

QStringList mimeTypes() const override {
    return {"application/vnd.listmodel.item"};
}

bool dropMimeData(const QMimeData *data, Qt::DropAction action,
                  int row, int column, const QModelIndex &parent) override {
    if (action != Qt::MoveAction || !data->hasFormat("application/vnd.listmodel.item") || column != 0) {
        return false;
    }

    int sourceRow = data->data("application/vnd.listmodel.item").toInt();
    // 计算目标行号：拖到项上时parent有效，拖到空白处row为插入位置
    int destinationRow = parent.isValid() ? parent.row() : (row == -1 ? m_data.size() : row);

    if (sourceRow == destinationRow) return false;

    // 通知视图即将修改模型
    beginResetModel();
    QString item = m_data.takeAt(sourceRow);
    int insertPos = destinationRow > sourceRow ? destinationRow - 1 : destinationRow;
    m_data.insert(insertPos, item);
    endResetModel();

    return true;
}

关键注意点 #

• 图标模式下所有项的父索引均为QModelIndex()，处理时不要忽略这一特性。
• 拖拽目标行号需区分两种场景：拖到两个项之间时row为插入位置；拖到项上时parent为该项索引，需转换为对应行号。
• 必须严格调用Qt模型的begin/end系列通知方法，否则视图与模型会出现状态不一致，甚至引发崩溃。

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