PyQt5实现鼠标悬停QPushButton时长实时在tooltip显示的问题

原代码的核心问题 #

1. 事件绑定错误：self.button.leaveEvent = self.clear() 不是绑定事件处理方法，而是直接执行了clear()，导致程序初始化时就把计数清零，且后续鼠标离开按钮时不会触发任何操作。
2. 全局变量的不合理使用：全局变量i容易引发状态混乱，应该改用类的实例变量维护计数状态。
3. Tooltip未强制刷新：鼠标静止在按钮上时，仅更新tooltip文本不会自动触发重新显示，需要主动调用API强制刷新。
4. 计数逻辑不可靠：依赖underMouse()判断鼠标状态，在鼠标完全静止时可能出现判断偏差，更可靠的方式是通过enterEvent和leaveEvent明确标记鼠标的进入/离开状态。

修正后的代码 #

import sys
from PyQt5.QtWidgets import *
from PyQt5.QtCore import *

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.layout = QVBoxLayout()
        self.button = QPushButton("MyButton")
        
        # 用实例变量维护计数与鼠标状态，替代全局变量
        self.count = 0
        self.mouse_inside = False
        
        # 初始化tooltip
        self.update_tooltip()
        
        # 为按钮安装事件过滤器，监听进入/离开事件
        self.button.installEventFilter(self)
        
        # 定时器每秒触发一次计数更新
        self.timer = QTimer(self)
        self.timer.timeout.connect(self.update_count)
        self.timer.start(1000)
        
        self.widget = QWidget()
        self.widget.setLayout(self.layout)
        self.setCentralWidget(self.widget)
        self.layout.addWidget(self.button)
    
    def update_tooltip(self):
        """更新tooltip文本并强制显示（如果鼠标在按钮内）"""
        tooltip_text = f"{self.count} seconds has passed since you moved your mouse onto MyButton"
        self.button.setToolTip(tooltip_text)
        if self.mouse_inside:
            pos = QCursor.pos()
            QToolTip.showText(pos, tooltip_text, self.button)
    
    def update_count(self):
        """仅当鼠标在按钮内时，每秒更新计数"""
        if self.mouse_inside:
            self.count += 1
            self.update_tooltip()
    
    def eventFilter(self, obj, event):
        """事件过滤器，处理按钮的鼠标进入/离开事件"""
        if obj == self.button:
            if event.type() == QEvent.Enter:
                self.count = 0
                self.mouse_inside = True
                self.update_tooltip()
            elif event.type() == QEvent.Leave:
                self.count = 0
                self.mouse_inside = False
                QToolTip.hideText()
        return super().eventFilter(obj, event)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    mainWin = MainWindow()
    mainWin.show()
    sys.exit(app.exec_())

关键修正说明 #

• 事件过滤器：通过installEventFilter精准捕捉按钮的鼠标进入/离开事件，替代不可靠的underMouse()判断，确保状态变化的准确性。
• 实例变量管理状态：用self.count和self.mouse_inside维护计数与鼠标状态，避免全局变量带来的状态混乱。
• 强制刷新Tooltip：每次更新计数后调用QToolTip.showText()，确保鼠标静止时tooltip也能实时显示最新内容。
• 明确的状态切换逻辑：鼠标进入时重置计数并标记进入状态，离开时清零计数、标记离开状态并隐藏tooltip，完全符合需求。

内容的提问来源于stack exchange，提问作者温泽海