如何在Python Tkinter的Treeview中实现带下拉/切换按钮的分类菜单

需求说明 #

需要实现一个吉他设计工具的分类菜单界面：

• 包含通用选项、琴身选项、琴颈选项等主分类，点击主分类可展开/折叠对应的子选项（如琴颈选项下的琴颈木材、品数等）
• 点击子选项后，右侧区域显示对应的参数选择控件：下拉列表、切换开关（复选框）等（例如指板弧度可选14、12、10、12-16）

此前尝试在Treeview中直接嵌入控件失败，使用标签页也不符合需求，以下是改进后的实现方案：

解决方案代码 #

import tkinter as tk
from tkinter import ttk

class GuitarDesigner:
    def __init__(self, root):
        self.root = root
        self.root.title("吉他设计工具")
        
        # 存储当前显示的控件，用于切换时销毁旧控件
        self.current_widgets = []
        
        # 配置分类与对应子项的控件信息
        self.category_config = {
            "通用选项": {
                "惯用手": {"type": "combobox", "values": ["右手", "左手"]},
                "品牌": {"type": "combobox", "values": ["Fender", "Gibson", "Ibanez", "自定义"]}
            },
            "琴身选项": {
                "琴身木材": {"type": "combobox", "values": ["椴木", "桃花心木", "桤木", "岑木"]},
                "琴身形状": {"type": "combobox", "values": ["Stratocaster", "Telecaster", "Les Paul", "SG"]},
                "漆面颜色": {"type": "combobox", "values": ["黑色", "白色", "日落色", "原木色"]}
            },
            "琴颈选项": {
                "琴颈木材": {"type": "combobox", "values": ["枫木", "玫瑰木", "桃花心木"]},
                "指板弧度": {"type": "combobox", "values": ["14", "12", "10", "12-16"]},
                "品数": {"type": "combobox", "values": ["21", "22", "24"]},
                "带品记": {"type": "checkbutton", "text": "启用品记"}
            },
            "硬件选项": {
                "琴桥类型": {"type": "combobox", "values": ["固定琴桥", "单摇琴桥", "双摇琴桥"]},
                "旋钮类型": {"type": "combobox", "values": ["封闭旋钮", "开放旋钮"]},
                "带锁弦": {"type": "checkbutton", "text": "启用锁弦系统"}
            }
        }
        
        # 左侧Treeview导航栏
        self.tree_frame = ttk.Frame(root)
        self.tree_frame.pack(side=tk.LEFT, fill=tk.BOTH, expand=False, padx=5, pady=5)
        
        self.tree = ttk.Treeview(self.tree_frame, show="tree")
        self.tree.pack(fill=tk.BOTH, expand=True)
        self.tree.bind("<<TreeviewSelect>>", self.on_item_select)
        
        # 填充Treeview分类与子项
        for category, items in self.category_config.items():
            parent_node = self.tree.insert("", tk.END, text=category)
            for item_name in items.keys():
                self.tree.insert(parent_node, tk.END, text=item_name)
        
        # 右侧参数选择区域
        self.params_frame = ttk.Frame(root)
        self.params_frame.pack(side=tk.RIGHT, fill=tk.BOTH, expand=True, padx=5, pady=5)
        
        # 初始提示标签
        self.default_label = ttk.Label(self.params_frame, text="请选择左侧的参数项")
        self.default_label.pack(pady=50)
        self.current_widgets.append(self.default_label)
    
    def on_item_select(self, event):
        # 清除当前显示的所有控件
        for widget in self.current_widgets:
            widget.destroy()
        self.current_widgets.clear()
        
        selected_item = self.tree.selection()[0]
        selected_text = self.tree.item(selected_item, "text")
        parent_item = self.tree.parent(selected_item)
        
        # 选中主分类时显示提示文本
        if not parent_item:
            self.default_label = ttk.Label(self.params_frame, text="请选择左侧的参数项")
            self.default_label.pack(pady=50)
            self.current_widgets.append(self.default_label)
            return
        
        # 获取父分类名称与当前项配置
        parent_text = self.tree.item(parent_item, "text")
        item_config = self.category_config[parent_text][selected_text]
        
        # 根据配置创建对应控件
        if item_config["type"] == "combobox":
            label = ttk.Label(self.params_frame, text=f"{selected_text}:")
            label.pack(anchor=tk.W, padx=10, pady=(20, 5))
            combo = ttk.Combobox(self.params_frame, values=item_config["values"], state="readonly")
            combo.pack(fill=tk.X, padx=10, pady=(0, 10))
            combo.set(item_config["values"][0])
            self.current_widgets.extend([label, combo])
        
        elif item_config["type"] == "checkbutton":
            check_var = tk.BooleanVar()
            check_btn = ttk.Checkbutton(self.params_frame, text=item_config["text"], variable=check_var)
            check_btn.pack(anchor=tk.W, padx=10, pady=20)
            self.current_widgets.append(check_btn)

if __name__ == "__main__":
    root = tk.Tk()
    app = GuitarDesigner(root)
    root.geometry("800x500")
    root.mainloop()

方案说明 #

1. Treeview 导航实现：利用Treeview原生的展开/折叠功能完成主分类与子选项的层级展示，无需手动编写折叠逻辑
2. 动态控件加载：选中子选项时先销毁右侧旧控件，再根据预定义配置创建对应控件，保证界面整洁
3. 配置化管理：通过category_config字典统一管理所有分类、子项及控件参数，后续新增或修改分类只需调整该字典
4. 状态区分：区分主分类与子选项的选中状态，选中主分类时显示提示文本，选中子选项才加载对应参数控件

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