如何使用Python3(tkinter)实现鼠标悬停显示提示、移开隐藏消息的功能

实现思路 #

这个功能在tkinter生态中通常被称为Tooltip（悬浮提示），核心逻辑是通过事件绑定+延时计时实现：

• 监听鼠标进入目标区域/控件的<Enter>事件，启动计时，达到指定的悬停阈值后弹出提示窗口
• 监听鼠标离开目标区域/控件的<Leave>事件，销毁计时任务和已弹出的提示窗口
• 用无标题栏的Toplevel组件作为提示的承载窗口，设置为顶层悬浮避免被其他组件遮挡

可直接运行的完整实现代码 #

import tkinter as tk
from tkinter import ttk

class Tooltip:
    def __init__(self, widget, text, delay=500, **style_kwargs):
        """
        悬浮提示初始化
        :param widget: 要绑定提示的tkinter控件
        :param text: 提示文本内容
        :param delay: 悬停多久显示提示，单位毫秒，默认500ms
        :param style_kwargs: 样式参数，支持bg(背景色)、fg(文字颜色)、font(字体)
        """
        self.widget = widget
        self.text = text
        self.delay = delay
        self.tip_window = None
        self.timer_id = None
        # 样式默认配置
        self.style = {
            "bg": style_kwargs.get("bg", "#ffffe0"),
            "fg": style_kwargs.get("fg", "#000000"),
            "font": style_kwargs.get("font", ("微软雅黑", 9)),
            "borderwidth": 1,
            "padx": 3,
            "pady": 2
        }
        # 绑定事件
        self.widget.bind("<Enter>", self._enter_handler)
        self.widget.bind("<Leave>", self._leave_handler)
        self.widget.bind("<ButtonPress>", self._leave_handler)  # 点击时也隐藏提示

    def _enter_handler(self, event):
        """鼠标进入控件时启动计时器"""
        self._cancel_timer()
        self.timer_id = self.widget.after(self.delay, self._show_tip)

    def _leave_handler(self, event):
        """鼠标离开/点击控件时取消计时，销毁提示"""
        self._cancel_timer()
        self._hide_tip()

    def _cancel_timer(self):
        """取消待执行的显示计时任务"""
        if self.timer_id:
            self.widget.after_cancel(self.timer_id)
            self.timer_id = None

    def _show_tip(self):
        """显示悬浮提示窗口"""
        if self.tip_window:
            return
        # 计算提示窗口位置，默认在鼠标指针右下角10px位置
        x = self.widget.winfo_pointerx() + 10
        y = self.widget.winfo_pointery() + 10
        # 创建无框顶层窗口
        self.tip_window = tk.Toplevel(self.widget)
        self.tip_window.wm_overrideredirect(True)  # 移除标题栏和窗口边框
        self.tip_window.wm_geometry(f"+{x}+{y}")
        self.tip_window.wm_attributes("-topmost", True)  # 固定悬浮在所有窗口上层
        # 渲染提示文本
        tip_label = tk.Label(
            self.tip_window,
            text=self.text,
            bg=self.style["bg"],
            fg=self.style["fg"],
            font=self.style["font"],
            relief="solid",
            borderwidth=self.style["borderwidth"],
            padx=self.style["padx"],
            pady=self.style["pady"]
        )
        tip_label.pack()

    def _hide_tip(self):
        """销毁提示窗口"""
        if self.tip_window:
            self.tip_window.destroy()
            self.tip_window = None

# 示例用法
if __name__ == "__main__":
    root = tk.Tk()
    root.title("悬浮提示演示")
    root.geometry("400x250")

    # 给按钮绑定提示
    demo_btn = ttk.Button(root, text="鼠标悬停到我这里")
    demo_btn.pack(pady=50)
    Tooltip(demo_btn, text="这是按钮的悬浮提示，鼠标移开就会消失")

    # 给标签绑定自定义样式的提示
    demo_label = ttk.Label(root, text="也可以给任意tkinter控件绑定提示，还支持自定义样式")
    demo_label.pack(pady=10)
    Tooltip(
        demo_label,
        text="我是自定义样式的提示，300ms就会显示，背景是淡蓝色",
        delay=300,
        bg="#e0f7fa",
        font=("微软雅黑", 10)
    )

    root.mainloop()

扩展说明 #

• 如果需要给固定坐标区域（不是绑定到现成控件）添加提示，可以给根窗口绑定<Motion>事件，实时判断鼠标坐标是否落在目标范围内，再触发对应的提示逻辑
• 需要添加富文本、图标等自定义内容时，只需修改_show_tip方法中往Toplevel窗口里添加的组件即可
• 可以通过修改窗口透明度配合after方法，实现提示的渐入渐出动画效果

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