PyQt5拖拽问题：拖拽时忽略QGraphicsView内的控件

问题描述 #

基于PyQt5开发的图形应用中，从工具栏拖拽图形到QGraphicsView视口时，若鼠标经过视口内叠加的按钮（或其他UI控件），会触发QGraphicsScene的dragLeaveEvent，导致图形被提前放置到场景，无法继续拖拽。需要让这些视口内的控件完全不干扰拖拽流程。

问题根源 #

视口内的按钮属于独立的QWidget控件，默认会响应拖拽事件。当拖拽鼠标进入按钮区域时，系统会认为拖拽焦点从QGraphicsScene转移到了按钮上，从而触发Scene的dragLeaveEvent，提前结束拖拽流程。

解决方案 #

让视口内需要忽略的控件完全不处理拖拽事件，使拖拽事件能够继续传递给QGraphicsView和QGraphicsScene。具体实现可以通过自定义控件类，重写所有拖拽相关事件并直接忽略。

修改后的完整代码 #

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QGraphicsScene, QGraphicsView, QGraphicsItem, QToolBar, QPushButton, QVBoxLayout, QWidget, QLabel, QGraphicsEllipseItem
from PyQt5.QtGui import QDrag
from PyQt5.QtCore import Qt, QMimeData, QRectF, QPointF


class CircleItem(QGraphicsItem):
    def __init__(self, x, y, radius, parent=None):
        super().__init__(parent)
        self.shape = QGraphicsEllipseItem(x, y, radius, radius)

    def boundingRect(self):
        return QRectF(self.shape.boundingRect())

    def paint(self, painter, option, widget=None):
        self.shape.paint(painter, option, widget)


class DragDropWidget(QLabel):
    def __init__(self, shape_type):
        super().__init__(shape_type)
        self.shape_type = shape_type

    def mousePressEvent(self, event):
        drag = QDrag(self)
        drag.setHotSpot(event.pos())
        mime_data = QMimeData()
        mime_data.setText(self.shape_type)
        drag.setMimeData(mime_data)
        drag.exec_(Qt.MoveAction)


# 自定义忽略拖拽的按钮类
class IgnoreDragButton(QPushButton):
    def __init__(self, text, parent=None):
        super().__init__(text, parent)
        self.setAcceptDrops(False)  # 明确禁用控件的拖拽接收

    def dragEnterEvent(self, event):
        event.ignore()  # 忽略事件，不拦截拖拽流程

    def dragMoveEvent(self, event):
        event.ignore()

    def dragLeaveEvent(self, event):
        event.ignore()

    def dropEvent(self, event):
        event.ignore()


class CustomView(QGraphicsView):
    def __init__(self, scene):
        super(CustomView, self).__init__(scene)


class CustomScene(QGraphicsScene):
    def __init__(self):
        super(CustomScene, self).__init__()
        self.shape = None

    def dragEnterEvent(self, event):
        if event.mimeData().hasText() and not self.shape:
            # 仅在第一次进入场景时创建图形
            shape_type = event.mimeData().text()
            self.shape = CircleItem(0, 0, 100)
            self.addItem(self.shape)
        event.acceptProposedAction()

    def dragMoveEvent(self, event):
        if self.shape:
            self.shape.setPos(event.scenePos())
        event.acceptProposedAction()

    def dropEvent(self, event):
        self.shape = None
        event.acceptProposedAction()

    def dragLeaveEvent(self, event):
        # 仅当真正离开视口时才处理（现在不会因经过按钮触发）
        print("LEAVING!")
        self.shape = None
        event.acceptProposedAction()


class MainWindow(QMainWindow):
    def __init__(self):
        super(MainWindow, self).__init__()

        self.scene = CustomScene()
        self.view = CustomView(self.scene)

        toolbar = QToolBar("Shapes Toolbar")
        self.addToolBar(toolbar)
        circle_button = DragDropWidget('Circle')
        toolbar.addWidget(circle_button)

        # 主布局
        main_widget = QWidget()
        layout = QVBoxLayout()
        layout.addWidget(self.view)
        main_widget.setLayout(layout)
        self.setCentralWidget(main_widget)

        # 使用自定义的忽略拖拽按钮
        view_button = IgnoreDragButton('I want to ignore this button when drag/dropping')
        view_layout = QVBoxLayout()
        view_layout.addWidget(view_button)
        self.view.setLayout(view_layout)


if __name__ == '__main__':
    app = QApplication(sys.argv)
    mainWindow = MainWindow()
    mainWindow.setGeometry(100, 100, 800, 600)
    mainWindow.show()
    sys.exit(app.exec_())

关键修改点 #

1. 自定义IgnoreDragButton类：重写所有拖拽相关事件并调用event.ignore()，同时设置setAcceptDrops(False)，确保控件不拦截拖拽事件，让事件继续传递给父级的QGraphicsView和QGraphicsScene。
2. 优化Scene的dragEnterEvent：增加not self.shape判断，避免每次拖拽进入场景时重复创建图形。
3. 保留Scene的dragLeaveEvent：现在该事件只会在鼠标真正离开视口时触发，不会因经过按钮而误触发。

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