Tkinter多实例对象的双击绑定事件未按预期工作

我正在开发一款可查询数据库、展示返回数据并支持用户双击条目加载/展开内容的工具。编写了PickerObject类，每行数据对应该类的一个实例并放入父Frame中。当前代码的显示效果和鼠标悬停高亮功能正常，但双击事件仅对第一个创建的实例生效；补充的最小可复现示例中，双击事件完全失效。使用Python 3.9.7，Tkinter 8.6。

原始实现代码 #

class PickerObject(tk.Frame):
    def __init__(self, parent, row_id, row_items, callbacks):
        super().__init__(parent)

        self.callbacks = callbacks

        self.configure(highlightbackground='black')
        self.configure(highlightthickness=1)
        self.rowconfigure(20, weight=1)
        self.columnconfigure(3, weight=1)

        self.row_id=row_id
        self.widgets = {}
        if self.row_id == 'new_prompt':
            self.widgets['prompt'] = ttk.Label(self, text=row_items)
            self.widgets['prompt'].grid(row=0, column=0, rowspan=2, sticky=tk.W, pady=10)
        else:
            for k, v in row_items.items():
                self.widgets[k] = ttk.Label(self, **v['text'])
                self.widgets[k].grid(padx=(0,25), **v['grid'])

        self.grid(in_=parent, padx=5, pady=(5, 0), sticky=tk.W + tk.E)
        self.bind('<Enter>', self.enter)
        self.bind('<Leave>', self.leave)
        self.bind('<Double-Button-1>', self.on_double_click)

    def enter(self, event=None):
        self.config(background='light blue')
        for widget in self.widgets:
            self.widgets[widget].config(background='light blue')

    def leave(self, event=None):
        self.config(background='light grey')
        for widget in self.widgets:
            self.widgets[widget].config(background='light grey')

    def on_double_click(self, event=None):
        self.callbacks['open'](self.row_id)

最小可复现示例 #

import tkinter as tk
import tkinter.ttk as ttk


class Main(tk.Frame):
    def __init__(self, parent):
        super().__init__(parent)

        items = {}
        callback = {'open': self.open}

        f = tk.Frame(self)

        for i in range(5):
            items[i] = PickerObject(i, callback)
            items[i].pack(in_=f)

        f.pack()

    def open(self, id):
        print(f'ID = {id}')


class PickerObject(tk.Frame):
    def __init__(self, i, callback):
        super().__init__()

        self.id = i
        self.callbacks = callback

        self.widget = ttk.Label(self, text = f'Label: {i}')
        self.widget.pack()
        self.bind('<Enter>', self.enter)
        self.bind('<Leave>', self.leave)
        self.bind('<Double-Button-1>', self.on_double_click)

    def enter(self, event=None):
        self.config(background='light blue')
        self.widget.config(background='light blue')

    def leave(self, event=None):
        self.config(background='light grey')
        self.widget.config(background='light grey')

    def on_double_click(self, event=None):
        self.callbacks['open'](self.id)


if __name__ == '__main__':
    mw = tk.Tk()
    list_frame = Main(mw)
    list_frame.pack()
    mw.mainloop()

问题原因与解决方法 #

核心问题 #

1. 组件层级异常：最小复现示例中PickerObject初始化时未传入父容器参数，导致组件挂载层级混乱，事件无法正常传递。
2. 事件拦截：Tkinter中子组件（如ttk.Label）会优先捕获鼠标事件，导致父组件（PickerObject Frame）无法接收双击事件。
3. ttk组件样式限制：ttk组件的背景色无法直接通过config(background=...)修改，需通过样式类配置。

修复步骤 #

1. 修正组件父容器传入
   在创建PickerObject时必须指定父容器，同时修改其构造方法：

   # Main类中创建实例的代码修改为
   items[i] = PickerObject(f, i, callback)
   # PickerObject的构造方法修改为
   def __init__(self, parent, i, callback):
       super().__init__(parent)
   

2. 让父组件捕获子组件事件
   给内部的子组件（如Label）也绑定相同的双击事件，确保点击子组件时能触发父组件的回调：

   # 在PickerObject的__init__中添加
   self.widget.bind('<Double-Button-1>', self.on_double_click)
   

3. 适配ttk组件背景色设置
   使用ttk.Style定义样式类，替换直接修改background的方式：

   # 在PickerObject的__init__中初始化样式
   self.style = ttk.Style()
   self.style.configure('Normal.TLabel', background='light grey')
   self.style.configure('Hover.TLabel', background='light blue')
   self.widget = ttk.Label(self, text=f'Label: {i}', style='Normal.TLabel')
   
   # 修改enter/leave方法
   def enter(self, event=None):
       self.config(background='light blue')
       self.widget.config(style='Hover.TLabel')
   
   def leave(self, event=None):
       self.config(background='light grey')
       self.widget.config(style='Normal.TLabel')
   

修复后的完整最小示例 #

import tkinter as tk
import tkinter.ttk as ttk


class Main(tk.Frame):
    def __init__(self, parent):
        super().__init__(parent)

        items = {}
        callback = {'open': self.open}

        f = tk.Frame(self)

        for i in range(5):
            items[i] = PickerObject(f, i, callback)
            items[i].pack(fill=tk.X, padx=5, pady=2)

        f.pack(fill=tk.X, expand=True)

    def open(self, id):
        print(f'ID = {id}')


class PickerObject(tk.Frame):
    def __init__(self, parent, i, callback):
        super().__init__(parent)
        self.id = i
        self.callbacks = callback

        # 初始化ttk样式
        self.style = ttk.Style()
        self.style.configure('Normal.TLabel', background='light grey')
        self.style.configure('Hover.TLabel', background='light blue')

        self.widget = ttk.Label(self, text=f'Label: {i}', style='Normal.TLabel')
        self.widget.pack(fill=tk.X, padx=5, pady=5)
        
        # 给Frame和内部Label绑定事件
        self.bind('<Enter>', self.enter)
        self.bind('<Leave>', self.leave)
        self.bind('<Double-Button-1>', self.on_double_click)
        self.widget.bind('<Enter>', self.enter)
        self.widget.bind('<Leave>', self.leave)
        self.widget.bind('<Double-Button-1>', self.on_double_click)

    def enter(self, event=None):
        self.config(background='light blue')
        self.widget.config(style='Hover.TLabel')

    def leave(self, event=None):
        self.config(background='light grey')
        self.widget.config(style='Normal.TLabel')

    def on_double_click(self, event=None):
        self.callbacks['open'](self.id)


if __name__ == '__main__':
    mw = tk.Tk()
    mw.geometry('300x200')
    list_frame = Main(mw)
    list_frame.pack(fill=tk.BOTH, expand=True)
    mw.mainloop()

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