PyQt5如何实现鼠标按下拖拽时检测QPushButton悬停碰撞

Qt默认存在鼠标捕获机制：鼠标按键按下时，光标所在控件会独占所有后续鼠标事件，直到按键释放。拖动过程中其他控件不会触发Enter悬停事件，这就是你原有事件过滤器逻辑在按住拖动时失效的根本原因。

方案1：父层全局坐标碰撞检测（推荐，性能最优） #

完全不依赖控件的Enter事件，直接在承载按钮的父窗口层面监听鼠标移动，实时判断光标和按钮的碰撞即可，适配大量像素按钮的场景。

1. 先给所有像素按钮的父容器（主窗口/承载像素画布的QWidget）开启鼠标追踪：

   self.setMouseTracking(True)
   

2. 提前把所有像素按钮存入列表方便遍历，比如self.pixel_btn_list = [btn1, btn2, btn3...]
3. 重写父容器的三个鼠标事件，代码如下：

   from PyQt5.QtCore import Qt
   
   def mousePressEvent(self, event):
       if event.button() == Qt.LeftButton:
           self.mouse.pressed = True
           # 处理鼠标按下瞬间命中的按钮
           press_pos = event.pos()
           for btn in self.pixel_btn_list:
               if btn.geometry().contains(press_pos):
                   ui_logic.square_press(btn, "red")
                   btn.setProperty("has_paint", True)
                   break
       super().mousePressEvent(event)
   
   def mouseMoveEvent(self, event):
       # 仅在按住左键拖动时执行检测
       if self.mouse.pressed and event.buttons() == Qt.LeftButton:
           current_pos = event.pos()
           for btn in self.pixel_btn_list:
               hit = btn.geometry().contains(current_pos)
               if hit and not btn.property("has_paint"):
                   ui_logic.square_press(btn, "red")
                   btn.setProperty("has_paint", True)
               # 不需要拖过恢复颜色就删掉下面三行
               # elif not hit and btn.property("has_paint"):
               #     btn.setStyleSheet("")
               #     btn.setProperty("has_paint", False)
       super().mouseMoveEvent(event)
   
   def mouseReleaseEvent(self, event):
       if event.button() == Qt.LeftButton:
           self.mouse.pressed = False
           # 重置所有按钮的绘制标记，供下次操作使用
           for btn in self.pixel_btn_list:
               btn.setProperty("has_paint", False)
       super().mouseReleaseEvent(event)
   
   # 保留你原有的square_press方法即可
   def square_press(button,color):
       style = "QPushButton{background-color:" + color + "}"
       button.setStyleSheet(style)
   

方案2：释放鼠标捕获（适配少量按钮场景） #

如果按钮数量少，想沿用原有事件过滤器逻辑，只需要在按钮收到鼠标按下事件时主动释放鼠标捕获，就能让拖动过程中其他按钮正常触发Enter事件：

def eventFilter(self, a0, a1):
    if a1.type() == QtCore.QEvent.MouseButtonPress and a1.button() == QtCore.Qt.LeftButton:
        # 主动释放鼠标捕获，让其他控件能收到后续鼠标事件
        a0.releaseMouse()
        self.mouse.pressed = True
        ui_logic.square_press(a0, "red")
    elif a1.type() == QtCore.QEvent.Enter:
        if self.mouse.pressed:
            ui_logic.square_press(a0, "red")
    elif a1.type() == QtCore.QEvent.MouseButtonRelease and a1.button() == QtCore.Qt.LeftButton:
        self.mouse.pressed = False
    return super().eventFilter(a0, a1)

注意：该方案会破坏Qt默认的事件传递逻辑，按钮数量超过100个时会有明显性能问题，不推荐在像素画布场景使用。

• 给按钮加has_paint自定义属性做标记，避免重复给已上色按钮设置样式，减少不必要的渲染开销
• 若按钮嵌套在多层子控件中，需要用坐标转换方法统一坐标系，保证碰撞检测结果准确
• 像素画布场景优先选方案1，父层遍历检测的性能远高于给每个按钮单独挂载事件过滤器

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