Tkinter Listbox中<Button-1>与<Double-1>事件curselection()返回值差异问询

问题描述 #

使用Tkinter开发GUI时，将Listbox的触发事件从<Double-1>切换为<Button-1>后发现：<Button-1>事件下调用lb.curselection()需要两次点击才能返回当前选中项的准确索引，而<Double-1>事件的表现符合预期。请问这是什么原因？是否属于Tkinter的bug？

代码示例 #

import tkinter as tk

class GUI:
    def __init__(self):
        self.root = tk.Tk()

        self.lb = tk.Listbox(self.root)
        self.lb.pack(side="left")

        for i in range(10):
            self.lb.insert("end", f"Value {i}")
        
        # 替换为self.lb.bind("<Button-1>", self.gui_click_event)即可复现问题
        self.lb.bind("<Double-1>", self.gui_dblClick_event)


    def gui_dblClick_event(self, event):
        print(self.lb.curselection())
    
    def gui_click_event(self, event):
        print(self.lb.curselection())


    def mainloop(self):
        self.root.mainloop()


if __name__ == "__main__":
    rootWin = GUI()
    rootWin.mainloop()

事件输出对比 #

<Double-1>事件输出 #

• 点击"Value 0" → (0,)
• 点击"Value 1" → (1,)
• 点击"Value 2" → (2,)
• 点击"Value 3" → (3,)

<Button-1>事件输出 #

• 点击"Value 0" → ()
• 点击"Value 1" → (0,)
• 点击"Value 2" → (1,)
• 点击"Value 3" → (2,)

<Button-1>双击输出 #

• 第一次点击"Value 0" → ()
• 第二次点击"Value 0" → (0,)
• 第一次点击"Value 1" → (0,)
• 第二次点击"Value 1" → (1,)

原因分析 #

这不是Tkinter的bug，而是事件触发时机的差异导致的：

• <Button-1>事件在鼠标按下的瞬间就被触发，此时Listbox还未完成选中状态的更新操作，所以curselection()返回的是上一次的选中值（首次点击时无历史值，返回空元组）。
• <Double-1>事件是在双击动作完成后才触发，此时Listbox已经完成了选中状态的更新，所以能返回当前选中项的正确索引。

解决方法 #

有几种可行的修复方案：

1. 绑定<ButtonRelease-1>事件：该事件在鼠标释放时触发，此时Listbox的选中状态已经更新完成：

   self.lb.bind("<ButtonRelease-1>", self.gui_click_event)
   

2. 绑定<<ListboxSelect>>虚拟事件：该事件专门监听Listbox选中项的变化，无论通过点击、键盘导航等方式改变选中状态，都会触发：

   self.lb.bind("<<ListboxSelect>>", self.gui_select_event)
   

3. 延迟获取选中值：在<Button-1>事件中使用after()延迟几毫秒再调用curselection()，给Listbox足够的时间更新选中状态：

   def gui_click_event(self, event):
       self.root.after(10, lambda: print(self.lb.curselection()))
   

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