PyQt5如何捕获按钮hover事件信号？同类方案实现疑问

核心实现逻辑 #

• PyQt5中的原生QPushButton没有内置暴露可直接连接的hover进入、鼠标离开信号，这两个交互行为本质是QWidget基类层面的事件，未被QPushButton默认封装为对外可监听的信号
• 通用实现思路为：通过子类化QPushButton，重写基类自带的enterEvent（鼠标进入控件触发）、leaveEvent（鼠标离开控件触发）两个虚函数，在重写的方法中抛出自定义的可连接信号，完成hover事件的捕获

代码编写位置与完整示例 #

所有自定义逻辑都写在你自己的项目代码中，无需修改PyQt5的原生库文件，具体分为三个部分：

1. 导入所需依赖

   from PyQt5.QtWidgets import QPushButton, QWidget, QApplication
   from PyQt5.QtCore import pyqtSignal
   import sys
   

2. 定义带hover信号的自定义按钮类（与主窗口类同级编写即可）

   class HoverableButton(QPushButton):
       # 自定义两个信号，分别对应hover启动、hover结束状态
       hover_enter = pyqtSignal()
       hover_leave = pyqtSignal()
   
       # 重写鼠标进入事件
       def enterEvent(self, event):
           # 触发自定义hover进入信号
           self.hover_enter.emit()
           # 必须调用父类原生事件逻辑，保留按钮默认交互行为
           super().enterEvent(event)
   
       # 重写鼠标离开事件
       def leaveEvent(self, event):
           # 触发自定义hover离开信号
           self.hover_leave.emit()
           # 保留父类原生离开事件逻辑
           super().leaveEvent(event)
   

3. 主窗口逻辑中实例化、使用自定义按钮（写法和原生QPushButton完全一致）

   class MainWindow(QWidget):
       def __init__(self):
           super().__init__()
           self.resize(300, 200)
           # 实例化可捕获hover事件的按钮
           self.test_btn = HoverableButton("测试按钮", self)
           self.test_btn.resize(120, 40)
           # 连接自定义hover信号到处理函数
           self.test_btn.hover_enter.connect(self.handle_hover_start)
           self.test_btn.hover_leave.connect(self.handle_hover_end)
   
       def handle_hover_start(self):
           # 自定义hover触发时的逻辑，比如修改按钮样式、弹出提示
           self.test_btn.setText("鼠标已进入按钮")
   
       def handle_hover_end(self):
           # 自定义hover结束时的逻辑
           self.test_btn.setText("测试按钮")
   
   if __name__ == "__main__":
       app = QApplication(sys.argv)
       window = MainWindow()
       window.show()
       sys.exit(app.exec_())
   

实现注意事项 #

• 重写enterEvent、leaveEvent时必须调用父类的同名方法，否则会破坏按钮的默认状态绘制、交互反馈逻辑
• 这类场景不需要额外调用setMouseTracking(True)开启鼠标追踪，Qt默认在鼠标进入控件边界时就会触发enterEvent，离开边界时触发leaveEvent
• 不建议通过monkey patch直接修改原生QPushButton的全局行为，子类化实现的方式兼容性更强，不会影响项目中其他原生按钮的正常使用

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