PyQt矩形绘制工具鼠标事件异常问题求助

嗨，我看了你的问题和代码，找到问题根源啦！先把你的问题再梳理下：

我四处找了找但没找到解决办法，所以来求助了。我正在用Python+PyQt做一个简单的绘图软件，先从矩形绘制工具开始。不知道为啥（可能是我理解不到位），怎么都搞不定。程序运行后是空白界面，本来应该点击拖动就能用矩形工具画形状，界面上有个按钮但还没写功能。在绘图区域点击时，程序能读取鼠标点击事件，但移动和释放事件没反应。我加了调试输出可以看到这个情况。不过如果点击程序的外部边缘（比如边框部分），就能读取所有事件，甚至可以开始画矩形，只要从边缘开始拖动就行。我是全新安装的Python，用了新的虚拟环境，只装了必要的依赖。求各位大佬给点思路！提前谢过了！

问题原因 #

核心问题在于鼠标事件的传递逻辑：你把mousePressEvent、mouseMoveEvent这些事件处理函数写在了QMainWindow的子类里，但当你点击QGraphicsView区域时，鼠标事件会被QGraphicsView本身优先拦截处理，根本不会传递给父窗口（也就是你的Test主窗口）。只有当点击主窗口中没有子部件覆盖的空白区域（比如窗口边框、未被视图占满的空隙）时，事件才会落到主窗口的处理函数里，这就是为啥边缘点击能正常工作的原因。

解决方案 #

这里给你两种常用的解决思路，推荐第一种，代码结构更清晰：

方法一：子类化QGraphicsView，在自定义视图中处理事件

把绘图交互逻辑和视图绑定，这是PyQt绘图程序的标准做法，后续扩展功能也更方便。

修改后的完整代码：

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QPushButton, QGraphicsScene, QGraphicsView, QVBoxLayout, QWidget, QGraphicsRectItem
from PyQt5.QtGui import QPen, QColor
from PyQt5.QtCore import Qt, QPointF

# 自定义QGraphicsView子类，专门处理绘图相关的鼠标事件
class DrawingView(QGraphicsView):
    def __init__(self, scene, parent=None):
        super().__init__(scene, parent)
        self.start_point = None
        self.rect_item = None

    def mousePressEvent(self, event):
        # 只处理左键点击
        if event.button() == Qt.LeftButton:
            # 将屏幕坐标转换为场景坐标
            scene_pos = self.mapToScene(event.pos())
            self.start_point = scene_pos
            print(f"mousePressEvent: scene_pos = {scene_pos}")
        # 调用父类方法，保证其他默认事件逻辑正常执行
        super().mousePressEvent(event)

    def mouseMoveEvent(self, event):
        # 只有按住左键且已经记录起始点时才处理
        if self.start_point and event.buttons() & Qt.LeftButton:
            scene_pos = self.mapToScene(event.pos())
            top_left, width, height = self.create_rectangle(self.start_point, scene_pos)
            print(f"mouseMoveEvent: scene_pos = {scene_pos}, top_left = {top_left}, width = {width}, height = {height}")
            # 移除之前的临时矩形，避免重复绘制
            if self.rect_item:
                self.scene().removeItem(self.rect_item)
            # 创建新的矩形并添加到场景
            pen = QPen(QColor(0, 0, 255))
            pen.setWidth(2)
            self.rect_item = QGraphicsRectItem(top_left.x(), top_left.y(), width, height)
            self.rect_item.setPen(pen)
            self.scene().addItem(self.rect_item)
        super().mouseMoveEvent(event)

    def mouseReleaseEvent(self, event):
        if event.button() == Qt.LeftButton:
            print("mouseReleaseEvent")
            # 重置临时变量
            self.start_point = None
            self.rect_item = None
        super().mouseReleaseEvent(event)

    def create_rectangle(self, start_point, end_point):
        x = min(start_point.x(), end_point.x())
        y = min(start_point.y(), end_point.y())
        width = abs(start_point.x() - end_point.x())
        height = abs(start_point.y() - end_point.y())
        print(f"create_rectangle: start_point = {start_point}, end_point = {end_point}, x = {x}, y = {y}, width = {width}, height = {height}")
        return QPointF(x, y), width, height

class Test(QMainWindow):
    def __init__(self):
        super().__init__()
        self.initUI()
        self.image_path = None
        self.confirmed_rects = []

    def initUI(self):
        self.central_widget = QWidget()
        self.setCentralWidget(self.central_widget)
        self.layout = QVBoxLayout(self.central_widget)

        # 把按钮添加到布局里，之前你漏了这一步，现在按钮会正常显示
        self.fetch_random_button = QPushButton("Test")
        self.layout.addWidget(self.fetch_random_button)

        self.scene = QGraphicsScene(self)
        # 使用自定义的DrawingView替代原生QGraphicsView
        self.view = DrawingView(self.scene, self)
        self.layout.addWidget(self.view)

        self.setGeometry(100, 100, 800, 600)
        self.setWindowTitle('Test')

if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = Test()
    window.show()
    sys.exit(app.exec_())

方法二：给QGraphicsView安装事件过滤器

如果不想子类化视图，也可以在主窗口中通过事件过滤器拦截视图的鼠标事件：

只需要修改Test类的代码，其他部分不变：

class Test(QMainWindow):
    def __init__(self):
        super().__init__()
        self.initUI()
        self.image_path = None
        self.start_point = None
        self.rect_item = None
        self.confirmed_rects = []

    def initUI(self):
        self.central_widget = QWidget()
        self.setCentralWidget(self.central_widget)
        self.layout = QVBoxLayout(self.central_widget)

        self.fetch_random_button = QPushButton("Test")
        self.layout.addWidget(self.fetch_random_button)

        self.scene = QGraphicsScene(self)
        self.view = QGraphicsView(self.scene, self)
        self.layout.addWidget(self.view)
        # 给视图安装事件过滤器，拦截它的鼠标事件
        self.view.installEventFilter(self)

        self.setGeometry(100, 100, 800, 600)
        self.setWindowTitle('Test')

    def eventFilter(self, obj, event):
        # 只处理来自视图的事件
        if obj == self.view:
            if event.type() == event.MouseButtonPress:
                if event.button() == Qt.LeftButton:
                    scene_pos = self.view.mapToScene(event.pos())
                    self.start_point = scene_pos
                    print(f"mousePressEvent: scene_pos = {scene_pos}")
            elif event.type() == event.MouseMove:
                if self.start_point and event.buttons() & Qt.LeftButton:
                    scene_pos = self.view.mapToScene(event.pos())
                    top_left, width, height = self.create_rectangle(self.start_point, scene_pos)
                    print(f"mouseMoveEvent: scene_pos = {scene_pos}, top_left = {top_left}, width = {width}, height = {height}")
                    if self.rect_item:
                        self.scene.removeItem(self.rect_item)
                    pen = QPen(QColor(0, 0, 255))
                    pen.setWidth(2)
                    self.rect_item = QGraphicsRectItem(top_left.x(), top_left.y(), width, height)
                    self.rect_item.setPen(pen)
                    self.scene.addItem(self.rect_item)
            elif event.type() == event.MouseButtonRelease:
                if event.button() == Qt.LeftButton:
                    print("mouseReleaseEvent")
                    self.start_point = None
                    self.rect_item = None
        # 返回False，让事件继续传递给原对象，保证其他功能正常
        return super().eventFilter(obj, event)

    def create_rectangle(self, start_point, end_point):
        x = min(start_point.x(), end_point.x())
        y = min(start_point.y(), end_point.y())
        width = abs(start_point.x() - end_point.x())
        height = abs(start_point.y() - end_point.y())
        print(f"create_rectangle: start_point = {start_point}, end_point = {end_point}, x = {x}, y = {y}, width = {width}, height = {height}")
        return QPointF(x, y), width, height

额外小提示 #

你之前的代码里忘记把fetch_random_button添加到布局中，所以按钮不会显示，上面的代码已经帮你补上了~

备注：内容来源于stack exchange，提问作者Damion Owens