第 11 章　表格展示：Treeview（通讯录核心展示控件）★★★

# 第11章 例11.1：用 Treeview 建一个"姓名/电话/分类"表格
import tkinter as tk
from tkinter import ttk


class App:
    def __init__(self, root):
        self.root = root
        self.root.title("通讯录管理器 - 联系人表格")

        # ① 定义列：name/phone/cat 三个数据列（首列树形不用，全用 columns）
        self.tree = ttk.Treeview(
            self.root,
            columns=("name", "phone", "cat"),  # 列标识符
            show="headings",                    # 只显示列标题（不显示最左树形列）
            height=8,
        )
        # ② 给每列设标题文字
        self.tree.heading("name", text="姓名")
        self.tree.heading("phone", text="电话")
        self.tree.heading("cat", text="分类")
        # ③ 给每列设宽度与对齐（anchor="w" 左对齐，"center" 居中）
        self.tree.column("name", width=100, anchor="w")
        self.tree.column("phone", width=140, anchor="w")
        self.tree.column("cat", width=100, anchor="center")
        self.tree.pack(padx=20, pady=10, fill="both", expand=True)

        # ④ 插入 3 行；values 顺序必须和 columns 对应：(姓名, 电话, 分类)
        self.tree.insert("", tk.END, values=("张三", "13800000001", "同事"))
        self.tree.insert("", tk.END, values=("李四", "13800000002", "家人"))
        self.tree.insert("", tk.END, values=("王五", "13800000003", "客户"))


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

# 第11章 例11.2：数据列表 + refresh() 驱动 Treeview 重绘
import tkinter as tk
from tkinter import ttk


class App:
    def __init__(self, root):
        self.root = root
        self.root.title("通讯录管理器 - 数据驱动表格")

        # ① 数据层：每条联系人是一个 (姓名, 电话, 分类) 元组
        self.data = [
            ("张三", "13800000001", "同事"),
            ("李四", "13800000002", "家人"),
            ("王五", "13800000003", "客户"),
        ]

        self.tree = ttk.Treeview(
            self.root, columns=("name", "phone", "cat"), show="headings", height=8,
        )
        self.tree.heading("name", text="姓名")
        self.tree.heading("phone", text="电话")
        self.tree.heading("cat", text="分类")
        self.tree.column("name", width=100, anchor="w")
        self.tree.column("phone", width=140, anchor="w")
        self.tree.column("cat", width=100, anchor="center")
        self.tree.pack(padx=20, pady=10, fill="both", expand=True)

        self.count_label = ttk.Label(self.root, text="共 0 位")
        self.count_label.pack(padx=20, pady=10)

        # ② 首次按数据重绘
        self.refresh()

    def refresh(self):
        # ③ 清空所有行：get_children() 取全部行 id，用 * 解包传给 delete
        self.tree.delete(*self.tree.get_children())
        # ④ 从数据层逐条插入
        for row in self.data:
            self.tree.insert("", tk.END, values=row)
        self.count_label.config(text=f"共 {len(self.data)} 位")


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

# 第11章 例11.3：点击 Treeview 行，把该行数据回填到 Label
import tkinter as tk
from tkinter import ttk


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

        self.data = [
            ("张三", "13800000001", "同事"),
            ("李四", "13800000002", "家人"),
            ("王五", "13800000003", "客户"),
        ]

        self.tree = ttk.Treeview(
            self.root, columns=("name", "phone", "cat"), show="headings", height=8,
        )
        self.tree.heading("name", text="姓名")
        self.tree.heading("phone", text="电话")
        self.tree.heading("cat", text="分类")
        self.tree.column("name", width=100, anchor="w")
        self.tree.column("phone", width=140, anchor="w")
        self.tree.column("cat", width=100, anchor="center")
        self.tree.pack(padx=20, pady=10, fill="both", expand=True)

        # ① 绑定"选中行"事件：点任意一行都会调用 on_select
        self.tree.bind("<<TreeviewSelect>>", self.on_select)

        self.label = ttk.Label(self.root, text="（点击上方任意一行查看详情）")
        self.label.pack(padx=20, pady=10)

        self.refresh()

    def refresh(self):
        self.tree.delete(*self.tree.get_children())
        for row in self.data:
            self.tree.insert("", tk.END, values=row)

    def on_select(self, event):
        # ② selection() 返回选中行 id 元组，可能为空要先判断
        sel = self.tree.selection()
        if not sel:
            return
        # ③ item(行id, "values") 取该行数据，返回 (姓名, 电话, 分类)
        name, phone, cat = self.tree.item(sel[0], "values")
        self.label.config(text=f"姓名：{name}　电话：{phone}　分类：{cat}")


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