为何Tkinter画布Leave事件在Windows11与Linux Mint下表现不同？

现象 #

当光标从绿色Canvas移至其内部通过create_window嵌入的红色Frame时，Windows 11会触发Canvas的<Leave>事件，但Linux Mint不会。

原因 #

核心差异在于**Canvas-window-item（Tkinter Canvas的内置项，而非独立组件）**的跨平台处理逻辑：

• Windows 11将Canvas-window-item视为独立于Canvas的区域，进入该区域会判定为离开Canvas（逻辑合理，因Canvas-window-item拥有独立坐标系）
• Linux Mint则将Canvas-window-item的区域归为Canvas的一部分，光标进入时不会触发Canvas的<Leave>事件

测试代码 #

import tkinter as tk

root   = tk.Tk()
canvas = tk.Canvas(root, height=200, width=200, bg="green")
frame  = tk.Frame(canvas, width=100, height=100, background="red")

canvas.grid()
# 不使用grid布局，而是将frame作为Canvas-window-item嵌入
canvas.create_window(100,100, window=frame)

canvas.bind("<Enter>", lambda event: print("entered canvas"))
canvas.bind("<Leave>", lambda event: print("left canvas"))

root.mainloop()

规避方案 #

可根据需求选择两种统一行为的思路：

思路1：统一为“光标在Frame内时不算离开Canvas” #

通过维护Canvas的hover状态，在<Leave>事件中校验光标实际位置，避免Windows下误触发：

import tkinter as tk

root = tk.Tk()
canvas = tk.Canvas(root, height=200, width=200, bg="green")
frame = tk.Frame(canvas, width=100, height=100, background="red")

canvas.grid()
canvas.create_window(100,100, window=frame)

is_canvas_hovered = True

def on_canvas_enter(event):
    global is_canvas_hovered
    if not is_canvas_hovered:
        print("entered canvas")
        is_canvas_hovered = True

def on_canvas_leave(event):
    global is_canvas_hovered
    # 获取各组件的屏幕坐标范围
    cx, cy, cw, ch = canvas.winfo_rootx(), canvas.winfo_rooty(), canvas.winfo_width(), canvas.winfo_height()
    fx, fy, fw, fh = frame.winfo_rootx(), frame.winfo_rooty(), frame.winfo_width(), frame.winfo_height()
    px, py = root.winfo_pointerx(), root.winfo_pointery()
    
    # 检查光标是否仍在Canvas或Frame范围内
    if (cx <= px <= cx+cw and cy <= py <= cy+ch) or (fx <= px <= fx+fw and fy <= py <= fy+fh):
        return
    # 确实离开Canvas时触发逻辑
    print("left canvas")
    is_canvas_hovered = False

def on_frame_enter(event):
    global is_canvas_hovered
    if not is_canvas_hovered:
        on_canvas_enter(event)

canvas.bind("<Enter>", on_canvas_enter)
canvas.bind("<Leave>", on_canvas_leave)
frame.bind("<Enter>", on_frame_enter)

root.mainloop()

思路2：统一为“光标进入Frame时视为离开Canvas” #

针对Linux系统，手动触发Canvas对应的事件，对齐Windows行为：

import tkinter as tk
import sys

root = tk.Tk()
canvas = tk.Canvas(root, height=200, width=200, bg="green")
frame = tk.Frame(canvas, width=100, height=100, background="red")

canvas.grid()
canvas.create_window(100,100, window=frame)

def on_canvas_enter(event):
    print("entered canvas")

def on_canvas_leave(event):
    print("left canvas")

def on_frame_enter(event):
    if sys.platform.startswith('linux'):
        canvas.event_generate("<Leave>")

def on_frame_leave(event):
    if sys.platform.startswith('linux'):
        canvas.event_generate("<Enter>")

canvas.bind("<Enter>", on_canvas_enter)
canvas.bind("<Leave>", on_canvas_leave)
frame.bind("<Enter>", on_frame_enter)
frame.bind("<Leave>", on_frame_leave)

root.mainloop()

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