Python Tkinter自动补全弹窗鼠标选择后箭头导航异常问题

问题描述 #

使用Tkinter开发基于Listbox的自动补全弹窗，支持方向键导航、回车键/鼠标点击选择选项。方向键导航原本正常，但鼠标选择选项后，再次使用方向键会自动选中列表的第二个条目。

问题原因 #

当鼠标选择选项后，listbox_wiggie_index被重置为-1，再次按下方向键时，代码直接对-1执行加减操作：

• 按下Down键时，-1 +1 =0，本应选中第一个条目，但由于Tkinter Listbox的默认选中状态残留或索引计算逻辑的边界问题，导致实际选中第二个条目。
• 全局变量的初始化写法不规范，可能引发潜在的变量作用域问题。

解决方案 #

1. 修正方向键索引计算逻辑：当listbox_wiggie_index为-1时，按下Down键直接将索引设为0（第一个条目），按下Up键设为列表最后一个条目索引，避免对-1进行加减操作。
2. 规范全局变量初始化：移除全局作用域无效的global声明，直接初始化变量。
3. 清空Listbox残留状态：在重置列表时，同步清空Listbox的选中状态和激活状态，避免残留影响后续操作。

修改后的完整代码 #

import tkinter as tk

masterlist = ["Daniel", "Ronel", "Dana", "Elani", "Isabel", "Hercules", "Karien", "Amor", "Piet", "Koos", "Jan", "Johan", "Denise", "Jean", "Petri"]
listbox_wiggie_index = -1  # 直接初始化全局变量，移除无效的global声明

def new_list_for_listbox(*args):
    global listbox_wiggie_index
    
    listbox_wiggie_index = -1
    listbox_wiggie.delete(0, tk.END)
    # 清空残留的选中和激活状态
    listbox_wiggie.selection_clear(0, tk.END)
    listbox_wiggie.activate(-1)

    t = search_var.get()
    
    if t == "":
        listbox_wiggie.place_forget()
        return
    
    for e in masterlist:
        if t.lower() in e.lower():
            listbox_wiggie.insert(tk.END, e)
    
    place_listbox_wiggie()
    print(f"|new_list_for_listbox|New list was generated and listbox_wiggie was placed. Index = {listbox_wiggie_index}")

def place_listbox_wiggie():
    x = entry_wiggie.winfo_rootx() - root.winfo_rootx()
    y = entry_wiggie.winfo_rooty() - root.winfo_rooty() + entry_wiggie.winfo_height()
    
    listbox_wiggie.place(x=x, y=y)
    entry_wiggie.focus_set()

def listbox_mouse_selection(event=None):
    i = listbox_wiggie.curselection()[0]
    t = listbox_wiggie.get(i)
    print("|listbox_mouse_selection| Selection was made using mouse")
    write_value_to_label(t)

def write_value_to_label(teks):
    global listbox_wiggie_index
    
    label_wiggie.config(text=teks)
    listbox_wiggie.place_forget()
    # 清空Listbox选中状态
    listbox_wiggie.selection_clear(0, tk.END)
    entry_wiggie.focus_set()
    entry_wiggie.delete(0, tk.END)
    listbox_wiggie_index = -1
    print(f"|write_value_to_label|{teks} was written to label_wiggie")

def change_listbox_selection_after_arrow_press():
    global listbox_wiggie_index

    listbox_wiggie.selection_clear(0, tk.END)
    listbox_wiggie.selection_set(listbox_wiggie_index)
    listbox_wiggie.activate(listbox_wiggie_index)
    print(f'|change_listbox_selection_after_arrow_press|Selector of listbox_wiggie was changed to = {listbox_wiggie_index}')

def on_entry_wiggie_key_press(event):
    global listbox_wiggie_index

    if listbox_wiggie.size() > 0:
        if event.keysym == "Down":
            print(f'|on_entry_wiggie_key_press|Down was pressed. Before pressing, index = {listbox_wiggie_index}')
            # 修正索引逻辑：初始-1时直接设为0
            if listbox_wiggie_index == -1:
                listbox_wiggie_index = 0
            else:
                listbox_wiggie_index += 1
            if listbox_wiggie_index >= listbox_wiggie.size():
                listbox_wiggie_index = 0
            change_listbox_selection_after_arrow_press()

        elif event.keysym == "Up":
            print(f'|on_entry_wiggie_key_press|Up was pressed. Before pressing, index = {listbox_wiggie_index}')
            # 修正索引逻辑：初始-1时直接设为最后一个条目索引
            if listbox_wiggie_index == -1:
                listbox_wiggie_index = listbox_wiggie.size() - 1
            else:
                listbox_wiggie_index -= 1
            if listbox_wiggie_index < 0:
                listbox_wiggie_index = listbox_wiggie.size() - 1
            change_listbox_selection_after_arrow_press()

        elif event.keysym == "Return":
            print('|on_entry_wiggie_key_press|Return was pressed.')
            if 0 <= listbox_wiggie_index < listbox_wiggie.size():
                write_value_to_label(listbox_wiggie.get(listbox_wiggie_index))

        elif event.keysym == "Escape":
            print('|on_entry_wiggie_key_press|Escape was pressed.')
            listbox_wiggie.delete(0, tk.END)
            listbox_wiggie.place_forget()
            entry_wiggie.focus_set()

        else:
            print(f'|on_entry_wiggie_key_press|{event.keysym} was pressed.')
            listbox_wiggie_index = -1
    
    else:
        print(f'|on_entry_wiggie_key_press|{event.keysym} was pressed.')
        listbox_wiggie_index = -1

    print(f'|on_entry_wiggie_key_press|search_var = "{search_var.get()}". Focus = {root.focus_get()}. Index = {listbox_wiggie_index}.  ...curselection() = {listbox_wiggie.curselection()}')
    print()

root = tk.Tk()
root.title("Listbox appear after typing")
root.geometry("400x200")

search_var = tk.StringVar()
search_var.trace("w", new_list_for_listbox)

entry_wiggie = tk.Entry(root, textvariable=search_var, width=60)
entry_wiggie.pack(pady=5)
entry_wiggie.focus_set()
entry_wiggie.bind('<KeyRelease>', on_entry_wiggie_key_press)

listbox_wiggie = tk.Listbox(root)
listbox_wiggie.bind('<<ListboxSelect>>', listbox_mouse_selection)

label_wiggie = tk.Label(root, text="No option is selected.")
label_wiggie.pack(pady=5)

root.mainloop()

关键修改点 #

• 移除全局作用域无效的global listbox_wiggie_index声明，直接初始化变量。
• 在new_list_for_listbox中添加listbox_wiggie.selection_clear(0, tk.END)和listbox_wiggie.activate(-1)，清空Listbox的残留选中状态。
• 修改方向键处理逻辑：当listbox_wiggie_index为-1时，按下Down键直接设为0，按下Up键设为列表最后一个条目索引，避免对-1进行加减操作。
• 在write_value_to_label中添加listbox_wiggie.selection_clear(0, tk.END)，确保鼠标选择后清空Listbox选中状态。

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