本文针对 Tkinter 应用中跨 Frame 传递变量的常见问题，提供了一种清晰、易懂的解决方案。通过在目标 Frame 中定义一个专门的方法，并在切换 Frame 时调用该方法，可以安全有效地将数据从一个 Frame 传递到另一个 Frame，避免了使用全局变量等不良实践，并保证了数据的及时更新。
在 Tkinter 应用开发中，经常会遇到需要在不同的 Frame 之间传递数据的情况。例如，在一个 Frame 中用户输入信息，然后需要在另一个 Frame 中显示或处理这些信息。直接访问另一个 Frame 的变量或者使用全局变量虽然简单，但并不是最佳实践。本文将介绍一种更优雅、更可靠的方法来实现跨 Frame 变量传递。
核心思路：在目标 Frame 中定义一个数据接收方法
这种方法的关键在于，在需要接收数据的 Frame 中定义一个专门的方法，用于接收并处理传递过来的数据。然后，在切换 Frame 的时候，调用这个方法，将数据作为参数传递过去。
示例代码
假设我们有两个 Frame：SearchFrame 和 SearchResultsFrame。SearchFrame 包含一个搜索框和一个搜索按钮，用户输入搜索关键词后，点击搜索按钮，将搜索结果显示在 SearchResultsFrame 中。
import tkinter as tk
from tkinter import ttk
import customtkinter as ctk
class SearchFrame(ctk.CTkFrame):
def __init__(self, parent, controller):
ctk.CTkFrame.__init__(self, parent)
self.title = ctk.CTkLabel(self, text="Search")
self.title.pack()
self.searchBar = ctk.CTkEntry(self)
self.searchBar.pack()
self.searchBtn = ctk.CTkButton(self, text="Search", command=lambda: self.search(controller, self.searchBar.get()))
self.searchBtn.pack()
def search(self, controller, query):
# 模拟数据库查询
results = self.query_database(query)
# 切换到 SearchResultsFrame 并传递结果
controller.show_frame(SearchResultsFrame)
SearchResultsFrame.populate_page(self, results)
def query_database(self, query):
# 实际应用中，这里应该执行 SQL 查询
# 这里为了演示，返回一个模拟的结果
return [
{"Name": "Company A", "Industry": "Tech", "Postcode": "10001", "Status": "Active"},
{"Name": "Company B", "Industry": "Finance", "Postcode": "20002", "Status": "Inactive"},
]
class SearchResultsFrame(ctk.CTkFrame):
def __init__(self, parent, controller):
ctk.CTkFrame.__init__(self, parent)
self.title = ctk.CTkLabel(self, text='Search Results')
self.title.pack()
self.companies_title = ctk.CTkLabel(self, text='Companies:')
self.companies_title.pack()
self.searchResults_columns = [
'Name',
'Industry',
'Postcode',
'Status'
]
self.searchResults_tree = ttk.Treeview(self, columns=self.searchResults_columns, show='headings')
self.treeFormat(self.searchResults_columns, self.searchResults_tree)
self.searchResults_tree.pack(expand=True, fill='both')
self.home_btn = ctk.CTkButton(self, text="Home", command=lambda: controller.show_frame(DashboardFrame))
self.home_btn.pack()
def populate_page(self, results):
# 清空之前的搜索结果
for item in self.searchResults_tree.get_children():
self.searchResults_tree.delete(item)
# 将搜索结果插入到 Treeview 中
for row in results:
self.searchResults_tree.insert("", tk.END, values=(row['Name'], row['Industry'], row['Postcode'], row['Status']))
def treeFormat(self, columns, tree):
for col in columns:
tree.heading(col, text=col)
tree.column(col, width=100) # 设置列宽
class DashboardFrame(ctk.CTkFrame):
def __init__(self, parent, controller):
ctk.CTkFrame.__init__(self, parent)
label = ctk.CTkLabel(self, text="Dashboard")
label.pack(padx=10, pady=10)
button1 = ctk.CTkButton(self, text="Go to Search",
command=lambda: controller.show_frame(SearchFrame))
button1.pack()
class MainApp(tk.Tk):
def __init__(self, *args, **kwargs):
tk.Tk.__init__(self, *args, **kwargs)
self.geometry("800x600")
self.title("CRM App")
container = tk.Frame(self)
container.pack(side="top", fill="both", expand=True)
container.grid_rowconfigure(0, weight=1)
container.grid_columnconfigure(0, weight=1)
self.frames = {}
for F in (DashboardFrame, SearchFrame, SearchResultsFrame):
frame = F(container, self)
self.frames[F] = frame
frame.grid(row=0, column=0, sticky="nsew")
self.show_frame(DashboardFrame)
def show_frame(self, cont):
frame = self.frames[cont]
frame.tkraise()
if __name__ == "__main__":
app = MainApp()
app.mainloop()代码解释
-
SearchFrame 类：
- search() 方法：
- 获取搜索框中的查询内容。
- 调用 query_database() 方法模拟数据库查询，获取结果。
- 调用 controller.show_frame(SearchResultsFrame) 切换到 SearchResultsFrame。
- 关键步骤： 调用 SearchResultsFrame.populate_page(self, results) 将查询结果传递给 SearchResultsFrame。
- search() 方法：
-
SearchResultsFrame 类：
- populate_page(self, results) 方法：
- 接收来自 SearchFrame 的查询结果 results。
- 清空 Treeview 中之前的搜索结果。
- 将新的搜索结果插入到 Treeview 中显示。
- populate_page(self, results) 方法：
注意事项
- SearchResultsFrame.populate_page(self, results) 中的 self 参数是指 SearchFrame 实例，因为 populate_page 方法是在 SearchFrame 的 search 方法中调用的。如果要访问 SearchResultsFrame 内部的组件，应该使用 self (在 SearchResultsFrame 内部) 或者 controller.frames[SearchResultsFrame]（在 MainApp 中）。
- query_database() 方法只是一个模拟，实际应用中应该替换为真正的数据库查询代码。
- 确保在 SearchResultsFrame 的 __init__ 方法中创建 Treeview 组件，否则 populate_page() 方法无法访问它。
- 使用 controller.show_frame() 方法切换 Frame 时，Tkinter 并不会重新创建 Frame 实例，而是将已经存在的 Frame 显示出来。因此，需要手动更新 Frame 中的内容。
总结
通过在目标 Frame 中定义一个专门的方法来接收数据，可以实现安全、高效的跨 Frame 变量传递。这种方法避免了使用全局变量，提高了代码的可维护性和可扩展性。同时，通过在切换 Frame 时调用该方法，可以保证数据的及时更新，避免显示旧数据。 这种模式可以推广到更复杂的数据传递场景，例如传递对象、列表、字典等。
