Python Tkinter是否支持复选列表框？（非独立复选框列表）

当然可以用Tkinter实现这种带复选框的列表框！虽然Tkinter本身没有原生的复选列表框组件，但我们可以用ttk.Treeview来模拟，效果完全能满足你的需求。

核心实现思路 #

• 借助ttk.Treeview组件：它支持多列布局，我们可以把默认的图标列（#0列）用来显示复选框，另一列展示列表内容。
• 用Unicode字符模拟复选框：无需额外图片，用空心方框（\u2610）和带勾方框（\u2611）来表示未选中和选中状态，跨平台兼容性好。
• 绑定点击事件：监听用户点击复选框列的操作，切换状态并维护选中项的列表。

完整可运行代码示例 #

import tkinter as tk
from tkinter import ttk

class CheckListBox:
    def __init__(self, parent, items):
        self.parent = parent
        self.items = items
        self.checked_items = []  # 存储选中的项

        # 创建Treeview，只显示内容列，默认的#0列用来放复选框
        self.tree = ttk.Treeview(parent, columns=("content"), show="headings")
        self.tree.heading("content", text="选项")
        self.tree.column("content", width=200)

        # 自定义样式，调整行高让显示更舒适
        style = ttk.Style()
        style.configure("Treeview", rowheight=25)

        # 定义复选框的两种状态字符
        self.unchecked = "\u2610"
        self.checked = "\u2611"

        # 插入所有初始选项
        for item in items:
            self.tree.insert("", tk.END, values=(item,), text=self.unchecked)

        # 绑定左键点击事件，处理复选框切换
        self.tree.bind("<Button-1>", self.toggle_checkbox)

        self.tree.pack(padx=10, pady=10, fill=tk.BOTH, expand=True)

    def toggle_checkbox(self, event):
        # 获取点击的行和列
        clicked_row = self.tree.identify_row(event.y)
        clicked_col = self.tree.identify_column(event.x)

        # 只处理复选框列（#0列）的点击
        if clicked_col == "#0" and clicked_row:
            current_state = self.tree.item(clicked_row, "text")
            item_content = self.tree.item(clicked_row, "values")[0]

            if current_state == self.unchecked:
                # 切换为选中状态
                self.tree.item(clicked_row, text=self.checked)
                self.checked_items.append(item_content)
            else:
                # 切换为未选中状态
                self.tree.item(clicked_row, text=self.unchecked)
                self.checked_items.remove(item_content)

# 测试用例
if __name__ == "__main__":
    root = tk.Tk()
    root.title("Tkinter 复选列表框")
    root.geometry("300x400")

    # 示例选项
    sample_items = ["项目A", "项目B", "项目C", "项目D", "项目E"]
    checklist = CheckListBox(root, sample_items)

    # 添加按钮查看选中的项
    def show_selected():
        print("当前选中的项：", checklist.checked_items)

    ttk.Button(root, text="查看选中项", command=show_selected).pack(pady=5)

    root.mainloop()

关键细节说明 #

1. 复选框状态切换：通过点击Treeview的#0列（左侧图标列）来触发状态切换，代码中会判断点击的列是否为目标列，避免误操作。
2. 选中项维护：用checked_items列表实时记录用户选中的内容，方便后续业务逻辑调用。
3. 样式自定义：可以通过调整ttk.Style的配置来修改行高、字体等，让组件更贴合你的GUI风格。如果需要更个性化的复选框图标，也可以用tk.PhotoImage加载本地图片替换Unicode字符。

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