问题根源：不当的 Toplevel 窗口初始化
在 tkinter 应用开发中，tk.toplevel 组件常用于创建独立的子窗口或对话框。然而，如果对其初始化方式理解不当，可能会导致意外行为，例如在创建单个 toplevel 窗口时，却出现两个窗口：一个正常的窗口和一个空白且无法关闭的额外窗口。
原始代码示例中，开发者尝试通过以下方式创建和初始化一个 Toplevel 窗口：
import tkinter as tk
# 假设 frmMain 已经是一个 tk.Tk() 实例
# frmMain = tk.Tk()
def createForm():
lFrm = tk.Toplevel() # 第一步：创建 Toplevel 实例
initForm(lFrm) # 第二步：手动调用初始化函数
return lFrm
def initForm(pFrm):
tk.Toplevel.__init__(pFrm) # 尝试手动初始化父类
# setWindowFocusEvent(pFrm) # 假设的自定义事件设置
# 示例调用
# def listBands():
# global frmMain
# frmMain.lListBandsFrm = createForm()这种方法的核心问题在于 tk.Toplevel() 的调用和 tk.Toplevel.__init__(pFrm) 的手动调用。当执行 lFrm = tk.Toplevel() 时，Tkinter 实际上已经完成了一个 Toplevel 实例的创建和初始化，并伴随着第一个窗口的出现。紧接着，initForm(lFrm) 中 tk.Toplevel.__init__(pFrm) 的手动调用，是对一个已经初始化过的对象再次进行“初始化”。在 Tkinter 的内部机制下，这种重复且不规范的初始化操作，尤其是在直接调用父类 __init__ 而非通过 super() 的情况下，可能被解释为需要创建一个新的窗口，从而导致第二个空白窗口的出现。这个额外的窗口通常难以控制，因为它并非通过标准流程创建和管理。
解决方案：正确继承与使用 super()
解决 tk.Toplevel 窗口重复出现的最佳实践是采用面向对象编程的继承机制，创建一个 tk.Toplevel 的子类，并在子类的 __init__ 方法中正确调用父类的 __init__。
以下是修正后的代码示例，它展示了如何通过子类化 tk.Toplevel 来避免重复窗口问题，并集成自定义的初始化逻辑：
import tkinter as tk
# 假设 setWindowFocusEvent 是一个用于设置窗口焦点事件的函数
# 实际应用中，此函数可能包含更复杂的逻辑，例如管理 MDI 窗口的 Z 序
def setWindowFocusEvent(window):
"""
为窗口设置焦点事件处理。
当窗口获得焦点时，可以在此处执行自定义逻辑。
"""
# print(f"为窗口 {window.winfo_name()} 设置焦点事件")
window.bind("", lambda event: print(f"窗口 {event.widget.winfo_name()} 获得焦点"))
class FrmMDI(tk.Toplevel): # 创建一个继承自 tk.Toplevel 的子类
"""
自定义的 MDI 风格子窗口类，封装了 Toplevel 的创建和初始化逻辑。
"""
def __init__(self, master=None): # 构造函数，master 参数可选
# 关键：正确调用父类 tk.Toplevel 的构造函数
# super() 会根据 MRO 找到并调用正确的父类方法
super().__init__(master)
# 在这里可以添加自定义的初始化逻辑和组件
self.title("自定义子窗口")
self.geometry("300x200")
self.wm_protocol("WM_DELETE_WINDOW", self.on_closing) # 绑定关闭事件
tk.Label(self, text="这是一个自定义子窗口").pack(pady=20)
tk.Button(self, text="关闭此窗口", command=self.on_closing).pack(pady=10)
setWindowFocusEvent(self) # 调用自定义的窗口准备函数
def on_closing(self):
"""处理窗口关闭事件。"""
print(f"关闭窗口: {self.winfo_name()}")
self.destroy() # 销毁窗口实例
def createForm(): # 简化后的窗口创建函数
"""
创建并返回一个 FrmMDI 实例。
"""
lFrm = FrmMDI() # 直接实例化自定义的子窗口类
return lFrm
# 主程序入口
if __name__ == "__main__":
frmMain = tk.Tk()
frmMain.title("主窗口")
frmMain.geometry("400x300")
frmMain.winfo_name("主程序窗口") # 设置窗口名称便于识别
def open_custom_form():
"""
打开一个新的自定义子窗口。
"""
new_form = createForm()
# 可以对 new_form 进行进一步操作，例如设置模态等
# new_form.grab_set() # 使其成为模态窗口，阻塞主窗口直到它关闭
# new_form.wait_window() # 等待模态窗口关闭
tk.Button(frmMain, text="打开自定义子窗口", command=open_custom_form).pack(pady=50)
frmMain.mainloop() 代码解析与注意事项：
子类化 tk.Toplevel: 通过 class FrmMDI(tk.Toplevel): 我们创建了一个新的类 FrmMDI，它继承了 tk.Toplevel 的所有功能。这是扩展 Tkinter 控件行为的标准方式，也是实现自定义窗口类型的基础。
__init__ 方法: 在 FrmMDI 类中定义 __init__ 方法是关键。当 FrmMDI 的实例被创建时（例如 lFrm = FrmMDI()），这个方法会被自动调用，负责新对象的初始化。
-
super().__init__(master): 这是解决重复窗口问题的核心。super().__init__(master) 的作用是调用父类 tk.Toplevel 的 __init__ 方法。
- 它确保了 Toplevel 窗口的所有必要初始化步骤只被执行一次，并且是在正确的上下文环境中执行。
- super() 会根据 Python 的 MRO（Method Resolution Order，方法解析顺序）智能地找到并调用下一个父类的 __init__ 方法，避免了手动指定父类名称可能带来的混淆和潜在错误。
- master 参数（可选）用于指定新 Toplevel 窗口的父窗口。虽然 Toplevel 窗口在视觉上是独立的，但在内部它仍然可以与一个主窗口关联，这对于管理窗口层级和行为有时很有用。
自定义逻辑封装: 在 super().__init__(master) 调用之后，你可以添加任何 FrmMDI 特有的初始化逻辑，例如设置窗口标题、尺寸、添加控件、绑定事件（如 wm_protocol 来处理关闭按钮）等。这样，所有的窗口设置和行为都被封装在 FrmMDI 类内部，提高了代码的模块化和可维护性。
避免直接调用 tk.Toplevel.__init__(self): 如前所述，直接调用 tk.Toplevel.__init__(pFrm) 是一种不规范且容易出错的做法。它绕过了 Python 的继承机制，可能导致重复初始化或状态不一致。始终使用 super().__init__() 来调用父类的构造函数。
总结
在使用 Tkinter 创建自定义 Toplevel 窗口时，避免重复窗口出现的关键在于正确地使用面向对象编程的继承特性。通过创建 tk.Toplevel 的子类，并在其 __init__ 方法中通过 super().__init__() 调用父类的构造函数，可以确保每个窗口实例都得到恰当且唯一的初始化。这种方法不仅解决了重复窗口的问题，也使得代码结构更加清晰、专业且易于维护。遵循这些最佳实践，将有助于构建稳定可靠的 Tkinter GUI 应用程序。
