QTreeWidget中按钮项拖拽及项移动不复制的实现方案问询

问题1：嵌入按钮的项无法拖拽 #

原因 #

通过setItemWidget嵌入的自定义控件（包括容器、标签、按钮）默认会拦截鼠标事件，QTreeWidget无法接收到鼠标按下、移动的事件信号，无法启动拖拽流程。

修复配置 #

• 给容器、非交互类的嵌入控件（如示例中用于拖拽提示的dragHandle标签）添加Qt.WA_TransparentForMouseEvents属性，让这类控件不拦截鼠标事件，事件直接透传给下层的QTreeWidget项，触发拖拽逻辑。
• 注意：需要响应点击的QPushButton不要设置该属性，否则按钮会失去点击交互能力。
• 给所有可拖拽的树节点设置正确的项标志：包含Qt.ItemIsEnabled | Qt.ItemIsSelectable | Qt.ItemIsDragEnabled | Qt.ItemIsDropEnabled，确保节点支持拖拽、放置操作。

问题2：拖拽生成副本而非真实移动 #

原因 #

仅设置setDragDropMode(self.InternalMove)不足以强制触发移动行为，默认拖放动作可能为复制，导致原位置项保留、目标位置生成新副本。

修复配置 #

显式调用setDefaultDropAction(Qt.MoveAction)，指定树控件内部拖放的默认行为为移动，拖拽完成后会自动移除原位置的项。

修复后完整可运行代码 #

import sys
from PyQt5.QtCore import Qt
from PyQt5.QtWidgets import (
    QApplication, QTreeWidget, QTreeWidgetItem,
    QPushButton, QLabel, QWidget, QHBoxLayout
)

class Example(QTreeWidget):
    def __init__(self):
        super().__init__()
        # 基础窗口配置
        self.setWindowTitle('Drag and Drop Button')
        self.setGeometry(300, 300, 550, 450)
        
        # 拖拽核心配置
        self.setDragEnabled(True)
        self.setAcceptDrops(True)
        self.setDragDropMode(self.InternalMove)
        # 关键配置：指定默认拖放动作为移动，而非复制
        self.setDefaultDropAction(Qt.MoveAction)
        self.setSelectionMode(self.SingleSelection)

        # 根节点
        self.cities = QTreeWidgetItem(self)
        self.cities.setText(0, "Cities")
        self.cities.setFlags(
            Qt.ItemIsEnabled | Qt.ItemIsSelectable | Qt.ItemIsDropEnabled
        )

        # 普通文本项
        osloItem = QTreeWidgetItem(self.cities)
        osloItem.setText(0, "Oslo")
        bergenItem = QTreeWidgetItem(self.cities)
        bergenItem.setText(0, "Bergen")
        stavangerItem = QTreeWidgetItem(self.cities)
        stavangerItem.setText(0, "Stavanger")

        # 嵌入按钮的项
        button1 = QPushButton('Button1', self)
        button2 = QPushButton("Button2", self)
        label = QLabel("dragHandle")

        container = QWidget()
        # 容器设置鼠标事件透传，不拦截事件，不影响子按钮交互
        container.setAttribute(Qt.WA_TransparentForMouseEvents)
        # 拖拽标签设置鼠标事件透传，点击该区域可触发拖拽
        label.setAttribute(Qt.WA_TransparentForMouseEvents)
        
        containerLayout = QHBoxLayout(container)
        containerLayout.setContentsMargins(0,0,0,0)
        containerLayout.addWidget(label)
        containerLayout.addWidget(button1)
        containerLayout.addWidget(button2)

        b1 = QTreeWidgetItem(self.cities)
        # 给嵌入控件的节点设置拖拽相关标志
        b1.setFlags(
            Qt.ItemIsEnabled | Qt.ItemIsSelectable | Qt.ItemIsDragEnabled | Qt.ItemIsDropEnabled
        )
        self.setItemWidget(b1, 0, container)

        # 给普通文本项统一设置拖拽标志
        for item in [osloItem, bergenItem, stavangerItem]:
            item.setFlags(
                Qt.ItemIsEnabled | Qt.ItemIsSelectable | Qt.ItemIsDragEnabled | Qt.ItemIsDropEnabled
            )

def main():
    app = QApplication(sys.argv)
    ex = Example()
    ex.show()
    app.exec_()

if __name__ == '__main__':
    main()

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