Tkinter如何绑定顶级窗口关闭及destroy()调用触发事件

问题本质 #

WM_DELETE_WINDOW 协议仅响应窗口管理器发起的关闭请求（点击窗口右上角叉号、通过系统菜单关闭窗口），两类场景不会触发该协议绑定的函数：

• 代码中主动调用窗口的.destroy()方法
• 主窗口销毁时，级联销毁其下所有Toplevel子窗口

实现方案 #

需要额外绑定Tkinter原生<Destroy>事件，同时规避两个常见坑：

• <Destroy>事件会在窗口内所有子组件销毁时冒泡触发，必须判断触发事件的对象是否为窗口本身，避免逻辑误执行
• 增加状态标记，避免WM_DELETE_WINDOW处理逻辑和<Destroy>事件逻辑重复触发
• 原测试代码存在两处可直接导致运行报错的bug：继承父类tk.toplevel大小写错误、调用父类构造方法时漏传self参数

修正后完整代码 #

import tkinter as tk

class TestWidget(tk.Toplevel):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 关闭逻辑执行标记，防止重复触发
        self._close_handled = False
        # 绑定窗口管理器关闭按钮事件
        self.protocol("WM_DELETE_WINDOW", self.handle_close)
        # 绑定全场景销毁事件
        self.bind("<Destroy>", self.handle_destroy)

    def handle_close(self):
        """点击窗口关闭按钮时的逻辑"""
        if not self._close_handled:
            print("关闭按钮触发：可在此处弹出保存提示")
            # 如需拦截关闭，可在此处加判断，比如用户点取消就return不执行destroy
            self._close_handled = True
        self.destroy()

    def handle_destroy(self, event):
        """所有销毁场景都会触发的通用逻辑"""
        # 仅当事件触发对象是窗口本身时才执行，过滤子组件的销毁事件
        if event.widget is self and not self._close_handled:
            print("销毁事件触发：主动调用destroy()/主窗口连带销毁时均会走到此处")
            # 此处放置销毁前必须执行的通用逻辑：保存文件、清理资源等
            self._close_handled = True

if __name__ == "__main__":
    root = tk.Tk()
    root.title("主窗口")
    test_window = TestWidget(root)
    # 测试按钮：主动调用destroy销毁弹窗
    def active_destroy():
        test_window.destroy()
    tk.Button(root, text="主动销毁弹窗", command=active_destroy).pack(padx=30, pady=20)
    root.mainloop()

验证场景 #

以下三种操作均会正常触发你预设的处理逻辑：

• 点击Toplevel弹窗的右上角关闭按钮
• 点击主窗口按钮主动调用.destroy()销毁弹窗
• 直接关闭主窗口，连带销毁子弹窗

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