如何实现QTreeWidget项的文本拖拽功能？

完全可以实现类似QLineEdit/QTextEdit的文本拖拽效果，核心是自定义QTreeWidget子类，重写鼠标事件并处理拖拽数据逻辑。

完整实现代码 #

import sys
from PyQt5.QtWidgets import QApplication, QTreeWidget, QTreeWidgetItem
from PyQt5.QtCore import Qt, QDrag, QMimeData

class TextDragTreeWidget(QTreeWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.start_pos = None
        self.drag_item = None

    def mousePressEvent(self, event):
        # 保留父类点击逻辑，确保项选中功能正常
        super().mousePressEvent(event)
        if event.button() == Qt.LeftButton:
            # 记录点击位置与对应项
            self.start_pos = event.pos()
            self.drag_item = self.itemAt(self.start_pos)

    def mouseMoveEvent(self, event):
        # 仅处理左键拖拽且存在可拖拽项的情况
        if event.buttons() & Qt.LeftButton and self.drag_item:
            # 计算鼠标移动距离，避免误触拖拽
            distance = (event.pos() - self.start_pos).manhattanLength()
            if distance >= QApplication.startDragDistance():
                self.start_drag()

    def start_drag(self):
        # 创建拖拽对象并设置文本数据
        drag = QDrag(self)
        mime_data = QMimeData()
        # 获取项的第一列文本（可按需修改为其他列或多列拼接）
        item_text = self.drag_item.text(0)
        mime_data.setText(item_text)
        drag.setMimeData(mime_data)
        # 执行拖拽，使用复制动作（可改为MoveAction实现移动逻辑）
        drag.exec_(Qt.CopyAction)

data = {"Project A": ["file_a.py", "file_a.txt", "something.xls"],
        "Project B": ["file_b.csv", "photo.jpg"],
        "Project C": []}

app = QApplication(sys.argv)
# 替换为自定义的TreeWidget
tree = TextDragTreeWidget()
tree.setColumnCount(2)
tree.setHeaderLabels(["Name", "Type"])
items = []
for key, values in data.items():
    item = QTreeWidgetItem([key])
    for value in values:
        ext = value.split(".")[-1].upper()
        child = QTreeWidgetItem([value, ext])
        item.addChild(child)
    items.append(item)

tree.insertTopLevelItems(0, items)

tree.show()
sys.exit(app.exec())

关键逻辑说明 #

• 事件重写：
  • mousePressEvent：记录左键点击的位置和对应的TreeWidget项，确保拖拽目标准确。
  • mouseMoveEvent：判断鼠标移动距离是否达到系统默认阈值，避免误触发拖拽操作。
• 拖拽数据处理：
  • start_drag方法创建QDrag对象，将项的文本存入QMimeData并设置为纯文本格式，保证其他支持文本拖拽的控件（如QLineEdit、QTextEdit）能正常接收。
• 扩展方向：
  • 若需支持多选中项拖拽，可通过selectedItems()获取所有选中项，将文本用换行符或分隔符拼接后存入QMimeData。
  • 如需拖拽多列内容，可自定义MIME类型或直接拼接多列文本。

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