附录 B　常用事件速查

星级说明：★ 了解 · ★★ 理解 · ★★★ 掌握 · ★★★★ 重点必会。

一、bind 基本用法

想让控件"响应鼠标、键盘"，就要用到 bind（绑定）。最常见的写法：

# 附录B 示例：把事件绑定到类里的方法（语法已校验通过）
import tkinter as tk


class App:
    def __init__(self, root):
        self.root = root
        self.label = tk.Label(root, text="点我或按键")
        self.label.pack(padx=20, pady=20)
        # 绑定鼠标左键单击：回调 must 能接收 event 参数
        self.label.bind("<Button-1>", self.on_click)
        # 绑定回车键（绑在窗口 root 上，全局生效）
        self.root.bind("<Return>", self.on_enter)

    def on_click(self, event):                # 第一个参数是 self，第二个是 event
        print("点击坐标（相对控件）：", event.x, event.y)

    def on_enter(self, event):
        print("按下了键：", event.keysym)


if __name__ == "__main__":
    root = tk.Tk()
    App(root)
    root.mainloop()

要点（与正文 OOP 写法一致）：

• 绑定语法：控件.bind("<事件序列>", 回调函数)。
• 回调签名固定为 def 方法(self, event):——tkinter 触发事件时会自动把 event 对象传进来，所以方法必须留第二个参数 event（名字任意，习惯叫 event）。不加这个参数会报 TypeError。
• 绑在 self.root 上是"窗口级"事件（全局）；绑在某个具体控件上只对该控件生效。
• 想"叠加"多个绑定而不覆盖旧的，用 bind(..., add="+")。
• 还有 bind_all()（全程序）、bind_class()（某类控件）等扩展写法，用到再查官方文档。

二、事件序列写法表

tkinter 事件用一串 <...> 包裹的字符串表示，叫"事件序列"。下表覆盖本书最常见写法：

📌 两类事件要分清：
- 普通事件用尖括号包裹，如 <Button-1>、<Return>、<Key>。
- 虚拟事件（Virtual Event）用双尖括号 <<...>>，它表示"某个语义动作发生了"，而不是具体哪只鼠标/哪个键——例如 <<ComboboxSelected>> 无论你用鼠标点还是键盘选都会触发，比监听具体按键更稳妥。双尖括号是虚拟事件的标志，别写成单尖括号。

三、事件对象（event）常用属性

回调里拿到的 event 是个对象，里面装着这次事件的各种信息。常用属性：

📌 x/y vs x_root/y_root 区别：x/y 是相对"那个控件"左上角的坐标，适合在控件内部画图；x_root/y_root 是相对整个屏幕的坐标，做"拖拽窗口""弹出菜单跟随鼠标"时更实用。

📌 键盘事件三件套：想判断"按了哪个键"，优先用 keysym（人类可读，如 'Return'）；要精确区分物理键用 keycode；要拿实际输入的字符用 char。keysym 和 char 在 <Key>/<KeyPress> 事件中都有，num 只在鼠标按钮事件里有意义。

四、速查小结

• 绑定：控件.bind("<事件>", self.回调)，回调写 def 回调(self, event):。
• 鼠标看 <Button-1>/<Double-1>/<B1-Motion>/<Enter>；键盘看 <Return>/<Key>/<KeyPress-a>。
• 组合控件的状态变化优先用虚拟事件 <<ComboboxSelected>>、<<TreeviewSelect>>。
• 取坐标用 event.x/event.y，取按键名用 event.keysym，取触发控件用 event.widget。