本文旨在解决 Tkinter 应用中不同框架（Frame）之间数据传递的问题。通过实例演示，详细讲解如何将一个框架中的数据传递到另一个框架，并更新目标框架的内容。避免使用全局变量，采用更安全、更规范的方法，提高代码的可维护性和可扩展性。
Tkinter 框架间数据传递的常见问题
在构建复杂的 Tkinter 应用时，经常需要在不同的框架之间传递数据。例如，一个框架用于用户输入，另一个框架用于显示结果。直接访问另一个框架的变量通常不是一个好的做法，因为它会导致代码耦合性增加，难以维护和测试。
解决方案：通过控制器方法传递数据
一种更优雅的解决方案是在主控制器中定义一个方法，用于更新目标框架的数据。当需要传递数据时，调用该方法，并将数据作为参数传递。
示例代码
以下代码演示了如何使用这种方法在 SearchFrame 和 SearchResultsFrame 之间传递搜索查询：
import tkinter as tk
from tkinter import ttk
import customtkinter as ctk
# 模拟数据库查询
def query_database(query):
# 实际应用中替换为真实的数据库查询代码
results = [
{'Name': 'Company A', 'Industry': 'Tech', 'Postcode': '10001', 'Status': 'Active'},
{'Name': 'Company B', 'Industry': 'Finance', 'Postcode': '20002', 'Status': 'Inactive'},
{'Name': 'Company C', 'Industry': 'Healthcare', 'Postcode': '30003', 'Status': 'Active'},
]
filtered_results = [r for r in results if query.lower() in r['Name'].lower()]
return filtered_results
# 主应用窗口
class App(ctk.CTk):
def __init__(self):
ctk.CTk.__init__(self)
self.title("CRM App")
self.geometry("800x600")
self.shared_data = {} # 用于存储共享数据
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 (SearchFrame, SearchResultsFrame):
frame = F(container, self)
self.frames[F] = frame
frame.grid(row=0, column=0, sticky="nsew")
self.show_frame(SearchFrame)
def show_frame(self, cont):
frame = self.frames[cont]
frame.tkraise()
def update_search_results(self, query):
# 获取 SearchResultsFrame 实例
search_results_frame = self.frames[SearchResultsFrame]
# 调用 SearchResultsFrame 的 populate_page 方法，传递查询结果
search_results_frame.populate_page(query)
# 搜索窗口
class SearchFrame(ctk.CTkFrame):
def __init__(self, parent, controller):
ctk.CTkFrame.__init__(self, parent)
self.controller = controller
self.title_label = ctk.CTkLabel(self, text="Search")
self.title_label.pack()
self.search_bar = ctk.CTkEntry(self)
self.search_bar.pack()
self.search_btn = ctk.CTkButton(self, text="Search", command=self.perform_search)
self.search_btn.pack()
def perform_search(self):
query = self.search_bar.get()
# 调用主应用的 update_search_results 方法
self.controller.update_search_results(query)
self.controller.show_frame(SearchResultsFrame)
# 搜索结果窗口
class SearchResultsFrame(ctk.CTkFrame):
def __init__(self, parent, controller):
ctk.CTkFrame.__init__(self, parent)
self.controller = controller
self.title_label = ctk.CTkLabel(self, text="Search Results")
self.title_label.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(SearchFrame))
self.home_btn.pack()
def populate_page(self, query):
# 清空 Treeview
for item in self.searchResults_tree.get_children():
self.searchResults_tree.delete(item)
# 模拟数据库查询
results = query_database(query)
# 将查询结果插入 Treeview
for row in results:
self.searchResults_tree.insert("", "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) # 设置列宽
if __name__ == "__main__":
app = App()
app.mainloop()代码解释
-
App 类 (主应用):
- update_search_results(self, query): 接收搜索查询 query，然后获取 SearchResultsFrame 实例，并调用其 populate_page 方法，将查询传递给结果框架。
- show_frame(self, cont): 用于显示指定的框架。
-
SearchFrame 类 (搜索窗口):
- perform_search(self): 获取搜索栏中的查询文本，然后调用主应用 App 的 update_search_results 方法来传递查询，并切换到 SearchResultsFrame。
-
SearchResultsFrame 类 (搜索结果窗口):
- populate_page(self, query): 接收查询 query，然后使用它来查询数据库（这里使用模拟的 query_database 函数），最后将结果显示在 Treeview 控件中。 这个函数首先清空 Treeview 中现有的数据，然后用新的查询结果填充它。
- treeFormat(self, columns, tree): 设置 Treeview 的列标题和列宽。
运行方式
- 确保安装了 tkinter 和 customtkinter 库。可以使用 pip install tkinter customtkinter 安装。
- 将代码保存为 .py 文件（例如 crm_app.py）。
- 运行该文件：python crm_app.py
关键点
- 控制器方法: App 类的 update_search_results 方法充当控制器，负责在框架之间传递数据。
- 解耦: SearchFrame 和 SearchResultsFrame 彼此不知道对方的存在。它们通过 App 类进行通信，降低了耦合度。
- 数据更新: SearchResultsFrame 的 populate_page 方法负责接收数据并更新框架的内容。
注意事项
- 数据类型: 确保传递的数据类型与目标框架期望的类型一致。
- 错误处理: 在实际应用中，需要添加错误处理机制，例如处理数据库查询失败的情况。
- 线程安全: 如果需要在多线程环境中使用 Tkinter，需要注意线程安全问题。
总结
通过使用控制器方法，可以有效地在 Tkinter 应用的不同框架之间传递数据，避免使用全局变量，提高代码的可维护性和可扩展性。这种方法也使得代码更加模块化，易于测试和重用。 本教程提供了一个清晰的示例，展示了如何在实际应用中实现这种方法。
