PySide6中QListView间拖拽功能无法启动的问题排查及正确实现方案

你现在的代码只给QListView设置了dragEnabled和acceptDrops，但核心的列表模型没有实现拖拽所需的Qt模型接口，这就是拖拽连启动都做不到的原因。咱们一步步来修正这个问题：

问题根源 #

Qt的模型视图框架中，拖拽功能的核心逻辑是由模型（QAbstractListModel子类）来实现的，视图只是负责触发和显示拖拽动作。所以必须在模型中实现拖拽相关的方法，才能让拖拽正常工作。

具体修改步骤 #

1. 完善拖拽源模型（ToolboxListModel） #

需要添加三个关键方法：supportedDragActions、mimeTypes、mimeData，用来定义拖拽动作、数据格式和打包数据：

from typing import Union, Any
import PySide6
from PySide6 import QtCore
from PySide6.QtCore import Qt
from models.model_data import MyModel
import json

class ToolboxListModel(QtCore.QAbstractListModel):
    def __init__(self):
        super().__init__()
        self.toolbox_items: list[MyModel] = []

    def data(self, index: Union[PySide6.QtCore.QModelIndex, PySide6.QtCore.QPersistentModelIndex], role: int = ...) -> Any:
        if role == Qt.DisplayRole:
            model = self.toolbox_items[index.row()]
            return model.x

    def rowCount(self, parent: Union[PySide6.QtCore.QModelIndex, PySide6.QtCore.QPersistentModelIndex] = ...) -> int:
        return len(self.toolbox_items)

    # 添加拖拽支持的动作（这里用复制，也可以用移动）
    def supportedDragActions(self) -> Qt.DropActions:
        return Qt.CopyAction

    # 声明支持的MIME类型，自定义一个类型方便识别
    def mimeTypes(self) -> list[str]:
        return ["application/my-model"]

    # 打包拖拽的数据，把MyModel序列化成JSON字节
    def mimeData(self, indexes: list[PySide6.QtCore.QModelIndex]) -> QtCore.QMimeData:
        mime_data = QtCore.QMimeData()
        if indexes:
            # 取第一个选中的项（如果是多选可以循环处理）
            item = self.toolbox_items[indexes[0].row()]
            # 序列化MyModel为JSON字符串再转字节
            json_data = json.dumps({"x": item.x}).encode()
            mime_data.setData("application/my-model", json_data)
        return mime_data

2. 完善拖拽目标模型（PipelineListModel） #

需要添加supportedDropActions、dropMimeData方法，还要注意添加数据时调用模型的通知方法，保证视图更新：

from typing import Union, Any
import PySide6
from PySide6 import QtCore
from PySide6.QtCore import Qt
from models.model_data import MyModel
import json

class PipelineListModel(QtCore.QAbstractListModel):
    def __init__(self):
        super().__init__()
        self.toolbox_items: list[MyModel] = []

    def data(self, index: Union[PySide6.QtCore.QModelIndex, PySide6.QtCore.QPersistentModelIndex], role: int = ...) -> Any:
        if role == Qt.DisplayRole:
            model = self.toolbox_items[index.row()]
            return model.x

    def rowCount(self, parent: Union[PySide6.QtCore.QModelIndex, PySide6.QtCore.QPersistentModelIndex] = ...) -> int:
        return len(self.toolbox_items)

    # 支持的放置动作，和源模型对应
    def supportedDropActions(self) -> Qt.DropActions:
        return Qt.CopyAction

    # 处理拖拽过来的数据
    def dropMimeData(self, data: QtCore.QMimeData, action: Qt.DropAction, row: int, column: int, parent: Union[PySide6.QtCore.QModelIndex, PySide6.QtCore.QPersistentModelIndex]) -> bool:
        # 检查是否是我们自定义的MIME类型
        if action == Qt.IgnoreAction:
            return True
        if not data.hasFormat("application/my-model"):
            return False
        
        # 解析数据，转成MyModel对象
        json_data = data.data("application/my-model").data().decode()
        item_dict = json.loads(json_data)
        new_item = MyModel(x=item_dict["x"])

        # 插入数据到模型中，必须调用beginInsertRows和endInsertRows来通知视图更新
        if row == -1:
            # 如果row是-1，插入到父节点的末尾（这里父节点是根，所以添加到列表最后）
            row = self.rowCount(parent)
        self.beginInsertRows(parent, row, row)
        self.toolbox_items.insert(row, new_item)
        self.endInsertRows()
        return True

3. 可选：优化视图的拖拽行为 #

如果你希望拖拽时支持多选，可以给源视图添加额外设置：

toolbox_list_view = QListView()
toolbox_list_view.setDragEnabled(True)
toolbox_list_view.setSelectionMode(QListView.ExtendedSelection)  # 支持多选拖拽
toolbox_list_view.setModel(toolbox_list_model)

为什么这样修改？ #

• supportedDragActions和supportedDropActions：告诉Qt这个模型支持什么样的拖拽/放置动作（复制、移动等）
• mimeTypes：声明拖拽数据的格式，避免和其他应用的拖拽数据冲突
• mimeData：把模型中的数据打包成Qt能识别的QMimeData对象，这是拖拽能传递数据的核心
• dropMimeData：接收并解析拖拽数据，然后更新模型，同时必须调用beginInsertRows和endInsertRows，否则视图不会刷新显示新添加的项

现在运行你的代码，应该就能正常启动拖拽，并且把Toolbox里的项拖到Pipeline列表里了。

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