Python Tkinter如何在函数执行中途弹出子窗口获取用户输入

问题场景 #

我正在开发Python Tkinter GUI程序，界面包含多框架，期望流程是：用户点击Run按钮→触发case=2弹出子窗口→用户完成选择点击Done→执行后续代码并使用选择值。但当前点击Run后，函数会直接执行后续代码，子窗口才弹出，根本无法获取用户选择值。

核心代码（主窗口） #

import tkinter as tk
class mainGUI:
    def __init__(self, parent, *args, **kwargs):
        self.parent = parent
        self.window_width = 1325
        self.window_height = 720
        self.frame1 = tk.Frame(...)
        self.frame1.grid(row=0, column=0)
        self.run_button = tk.Button(self.parent, text='Run', font=('Helvetica', 18), command=lambda: self.run_cmd(<inputs>))
        self.run_button.grid(row=1, column=0)
        
    def run_cmd(self, parent):
        <un-important code>
        case = 2
        if case == 2:
            userInput(self.parent)

        userSelection = userInput.val  # 此处会直接执行，等不到子窗口选择
        
        <rest of code>

root = tk.Tk()
mainGUI(root)
root.mainloop()

子窗口userInput类代码 #

class userInput:
    var = ''
    def __init__(self, parent):
        self.subwindow = tk.Toplevel(parent)
        self.subwindow.transient(parent)
        self.subwindow.title('User Input')
        self.window_width = 360
        self.window_height = 325

        # listbox frame
        self.listbox_frame = tk.Frame(self.subwindow, width=340, height=160, bg='white')
        self.listbox_frame.grid(row=1, column=0)
        self.listbox_frame.grid_propagate(False)
        # button frame
        self.button_frame = tk.Frame(self.subwindow, width=70, height=25, bg='white')
        self.button_frame.grid(row=2, column=0, padx=100, pady=0)
        self.button_frame.grid_propagate(False)

        self.listbox_done_button = tk.Button(self.button_frame, text="Done", command=lambda: self.user_select_done(self.listbox_selections, self.subwindow))
        self.listbox_done_button.grid(row=0, column=1, padx=5)

        listbox = tk.Listbox(frame,selectmode = "browse", exportselection=tk.FALSE, relief="groove")
        
        self.content = ['Selection1','Selection2','Selection3']
        for item in range(len(self.content)):   
            listbox.insert(tk.END, self.content[item])

    def user_select_done(self, listbox, subwindow):
        # print('file select')
        self.selectedItem = tf.getListboxSelects(listbox)
        if len(self.selectedItem) > 0:
            if self.selectedItem == 'Selection1':
                userInput.var = 'Selection1'
            elif self.selectedItem == 'Selection2':
                userInput.var = 'Selection2'
            elif self.selectedItem == 'Selection3':
                userInput.var = 'Selection3'
            subwindow.destroy()           
        else:
            userInput.var = 'None'
            subwindow.destroy()
            print('No selection made')

问题原因 #

Tkinter的Toplevel窗口默认是非阻塞的，创建后代码会立即继续执行，导致run_cmd中创建子窗口后立刻去取userInput.val时，用户还未完成选择，自然拿不到正确值。

解决方案 #

方案1：使用wait_window()阻塞主流程 #

通过wait_window()让主程序等待子窗口关闭后再继续执行，同时修正原代码中的小问题（如listbox父容器错误、未定义变量等）：

修改后的userInput类

class userInput:
    var = ''
    def __init__(self, parent):
        self.subwindow = tk.Toplevel(parent)
        self.subwindow.transient(parent)
        self.subwindow.title('User Input')
        self.window_width = 360
        self.window_height = 325

        # listbox frame
        self.listbox_frame = tk.Frame(self.subwindow, width=340, height=160, bg='white')
        self.listbox_frame.grid(row=1, column=0)
        self.listbox_frame.grid_propagate(False)
        # button frame
        self.button_frame = tk.Frame(self.subwindow, width=70, height=25, bg='white')
        self.button_frame.grid(row=2, column=0, padx=100, pady=0)
        self.button_frame.grid_propagate(False)

        # 修正listbox父容器为self.listbox_frame
        self.listbox = tk.Listbox(self.listbox_frame, selectmode="browse", exportselection=tk.FALSE, relief="groove")
        self.listbox.pack(fill=tk.BOTH, expand=True)

        self.content = ['Selection1','Selection2','Selection3']
        for item in self.content:   
            self.listbox.insert(tk.END, item)

        # 修正command参数，直接绑定方法
        self.listbox_done_button = tk.Button(self.button_frame, text="Done", command=self.user_select_done)
        self.listbox_done_button.grid(row=0, column=1, padx=5)

        # 等待子窗口关闭后再继续执行主流程
        self.subwindow.wait_window()

    def user_select_done(self):
        # 获取选中项
        selected_indices = self.listbox.curselection()
        if selected_indices:
            self.selectedItem = self.listbox.get(selected_indices[0])
            userInput.var = self.selectedItem
        else:
            userInput.var = 'None'
            print('No selection made')
        self.subwindow.destroy()

修改mainGUI的run_cmd方法

def run_cmd(self, parent):
    <un-important code>
    case = 2
    if case == 2:
        userInput(self.parent)  # 此处会等待子窗口关闭

    userSelection = userInput.var  # 现在能拿到正确的选择值
    print(f"用户选择了: {userSelection}")
    <rest of code>

方案2：使用回调函数（非阻塞） #

如果不想阻塞主流程，可以给userInput类传入回调函数，在用户点击Done后自动执行后续逻辑：

修改后的userInput类

class userInput:
    def __init__(self, parent, callback):
        self.callback = callback  # 保存回调函数
        self.subwindow = tk.Toplevel(parent)
        self.subwindow.transient(parent)
        self.subwindow.title('User Input')
        self.window_width = 360
        self.window_height = 325

        # listbox frame
        self.listbox_frame = tk.Frame(self.subwindow, width=340, height=160, bg='white')
        self.listbox_frame.grid(row=1, column=0)
        self.listbox_frame.grid_propagate(False)
        # button frame
        self.button_frame = tk.Frame(self.subwindow, width=70, height=25, bg='white')
        self.button_frame.grid(row=2, column=0, padx=100, pady=0)
        self.button_frame.grid_propagate(False)

        self.listbox = tk.Listbox(self.listbox_frame, selectmode="browse", exportselection=tk.FALSE, relief="groove")
        self.listbox.pack(fill=tk.BOTH, expand=True)

        self.content = ['Selection1','Selection2','Selection3']
        for item in self.content:   
            self.listbox.insert(tk.END, item)

        self.listbox_done_button = tk.Button(self.button_frame, text="Done", command=self.user_select_done)
        self.listbox_done_button.grid(row=0, column=1, padx=5)

    def user_select_done(self):
        selected_indices = self.listbox.curselection()
        if selected_indices:
            selected_item = self.listbox.get(selected_indices[0])
        else:
            selected_item = 'None'
            print('No selection made')
        self.subwindow.destroy()
        self.callback(selected_item)  # 执行回调，传递选择值

修改mainGUI类

class mainGUI:
    # ... 其他代码不变 ...
    def run_cmd(self, parent):
        <un-important code>
        case = 2
        if case == 2:
            # 传入回调函数，用户选择后自动执行
            userInput(self.parent, self.on_user_selection_done)
        # 后续逻辑不再直接执行，转移到回调方法中

    def on_user_selection_done(self, userSelection):
        # 处理用户选择后的逻辑
        print(f"用户选择了: {userSelection}")
        <rest of code>

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