第 15 章　事件绑定：bind 与事件对象（不止按钮能交互）

<[修饰符-]事件类型-细分子>

widget.bind(事件串, 回调函数)        # 绑定到 widget 自身
widget.bind(事件串, 回调函数, add="+")  # 追加绑定，不覆盖已有绑定

# 第15章 例15.1：在姓名输入框按回车，直接把名字加入列表
import tkinter as tk


class App:
    def __init__(self, root):
        self.root = root
        self.root.title("通讯录管理器")

        self.name_var = tk.StringVar()           # 用 StringVar 绑定输入框
        # 姓名输入框：textvariable 把输入内容实时存到 name_var
        self.entry = tk.Entry(self.root, textvariable=self.name_var, width=20)
        self.entry.pack(padx=10, pady=10)

        self.btn = tk.Button(self.root, text="添加(也可回车)", command=self.add)
        self.btn.pack(padx=10, pady=5)

        self.listbox = tk.Listbox(self.root, height=6)
        self.listbox.pack(padx=10, pady=10)

        # ★核心：把"回车键"绑定到 self.on_enter 方法
        #   bind 的第二个参数必须是"能接收 event 的方法"
        self.entry.bind("<Return>", self.on_enter)

    def on_enter(self, event):                    # 注意签名：第一个是 self，第二个是 event
        # event 这里用不到，但参数必须留着（bind 会传它）
        self.add()                                # 复用同一个添加逻辑

    def add(self):                               # 按钮和回车共用的方法
        name = self.name_var.get().strip()       # 取出输入并去空格
        if name:                                 # 非空才添加
            self.listbox.insert(tk.END, name)    # 加入列表框
            self.name_var.set("")                 # 清空输入框


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

# 第15章 例15.2：鼠标在画布上移动，实时显示坐标
import tkinter as tk


class App:
    def __init__(self, root):
        self.root = root
        self.root.title("通讯录管理器 - 坐标演示")

        self.label = tk.Label(self.root, text="把鼠标移到下面区域", font=("微软雅黑", 12))
        self.label.pack(padx=10, pady=5)

        # 一个画布，用来"接住"鼠标移动事件
        self.canvas = tk.Canvas(self.root, width=300, height=150, bg="white")
        self.canvas.pack(padx=10, pady=10)

        # 绑定鼠标移动事件到 self.show_pos
        self.canvas.bind("<Motion>", self.show_pos)

    def show_pos(self, event):                   # event 携带坐标信息
        x = event.x                              # 相对画布左上角的 x
        y = event.y                              # 相对画布左上角的 y
        # 把坐标拼成文字，实时更新 Label
        self.label.config(text=f"鼠标坐标：({x}, {y})")


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

# 第15章 例15.3：在列表框上点右键，弹出小菜单
import tkinter as tk


class App:
    def __init__(self, root):
        self.root = root
        self.root.title("通讯录管理器 - 右键菜单")

        self.listbox = tk.Listbox(self.root, height=6)
        self.listbox.pack(padx=10, pady=10)
        for n in ("张三", "李四", "王五"):
            self.listbox.insert(tk.END, n)

        # 先用 tk.Menu 做一个"临时弹出"菜单（tearoff=0 去掉顶部虚线）
        self.popup = tk.Menu(self.root, tearoff=0)
        self.popup.add_command(label="编辑", command=self.edit)
        self.popup.add_command(label="删除", command=self.delete)

        # 绑定右键：事件发生时，用 event 坐标把菜单弹出来
        self.listbox.bind("<Button-3>", self.show_popup)

    def show_popup(self, event):
        # event.x_root/.y_root 是相对"屏幕左上角"的坐标，弹菜单必须用它
        self.popup.post(event.x_root, event.y_root)

    def edit(self):
        print("编辑：", self.listbox.get(tk.ACTIVE))

    def delete(self):
        print("删除：", self.listbox.get(tk.ACTIVE))


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

# 第15章 例15.4：用 lambda 给回调"预设参数"（补齐第3章遗留问题）
import tkinter as tk


class App:
    def __init__(self, root):
        self.root = root
        self.root.title("通讯录管理器 - lambda 传参")

        # 想做 3 个按钮：分别添加 1 条、2 条、3 条示例联系人
        # 错误写法：command=self.add(n)  ← 带括号会"立刻执行"，而且只执行一次
        # 正确写法：用 lambda 把 n 包起来，点击时才调用
        for n in (1, 2, 3):
            btn = tk.Button(
                self.root,
                text=f"添加 {n} 条",
                # lambda n=n: ... 中 "n=n" 把当前循环值"锁"进这个 lambda
                # 否则所有 lambda 都会引用同一个最后的 n（闭包陷阱）
                command=lambda n=n: self.add(n),
            )
            btn.pack(padx=10, pady=4)

        self.listbox = tk.Listbox(self.root, height=8)
        self.listbox.pack(padx=10, pady=10)

    def add(self, n):
        # n 是从 lambda 传进来的参数
        for i in range(n):
            self.listbox.insert(tk.END, f"联系人 {i + 1}")


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

# 第15章 例15.5：Combobox 切换选项时，用虚拟事件刷新显示
import tkinter as tk
from tkinter import ttk


class App:
    def __init__(self, root):
        self.root = root
        self.root.title("通讯录管理器 - 虚拟事件")

        self.label = tk.Label(self.root, text="请选择分组", font=("微软雅黑", 12))
        self.label.pack(padx=10, pady=5)

        # ttk.Combobox：下拉选择框
        self.combo = ttk.Combobox(self.root, values=("家人", "朋友", "同事"), state="readonly")
        self.combo.pack(padx=10, pady=5)
        self.combo.set("朋友")                  # 设一个默认选中项

        # 绑定"选中项变化"这个虚拟事件（双层尖括号）
        self.combo.bind("<<ComboboxSelected>>", self.on_selected)

    def on_selected(self, event):              # 虚拟事件同样会传 event
        # event.widget 就是触发事件的控件，这里即 combo
        value = event.widget.get()             # 取出当前选中的文字
        self.label.config(text=f"当前分组：{value}")


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