closeEvent 是Qt框架中的一个事件处理函数，当一个窗口部件（最常见的是主窗口 QMainWindow）即将关闭时，系统会自动调用这个事件，通过重写（覆盖）这个方法,你可以在窗口关闭前执行自定义的逻辑，

• 询问用户是否确定关闭（最常见的用法）。
• 保存未保存的数据或文件。
• 清理资源，如关闭网络连接、停止定时器等。
• 最小化到系统托盘,而不是真正关闭窗口。

核心概念

closeEvent 接收一个 QCloseEvent 对象作为参数，这个对象代表了关闭事件本身,并且提供了关键的方法来控制后续行为：

• event.accept(): 接受关闭事件，窗口将正常关闭,这是默认行为。
• event.ignore(): 忽略关闭事件，窗口将不会关闭,保持原样。

重写 closeEvent 的基本模式是：

1. 执行你需要的预关闭逻辑（比如弹出一个对话框）。
2. 根据逻辑的结果，决定是调用 event.accept() 还是 event.ignore()。

示例代码

下面我们通过几个最常见和实用的场景来展示如何重写 closeEvent。

询问用户是否确认关闭（最经典用法）

这是 closeEvent 最广为人知的用途，当用户点击窗口的关闭按钮（'X'）时，弹出一个对话框，让用户选择是确认关闭、取消关闭还是最小化。

import sys
from PyQt5.QtWidgets import (QApplication, QMainWindow, QMessageBox, 
                             QPushButton, QVBoxLayout, QWidget)
class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("CloseEvent 示例")
        self.setGeometry(300, 300, 400, 200)
        # 设置一个中心部件
        central_widget = QWidget()
        self.setCentralWidget(central_widget)
        layout = QVBoxLayout()
        self.button = QPushButton("点击我，然后尝试关闭窗口")
        self.button.clicked.connect(self.on_button_click)
        layout.addWidget(self.button)
        central_widget.setLayout(layout)
    def on_button_click(self):
        QMessageBox.information(self, "提示", "按钮被点击了！")
    # --- 核心部分：重写 closeEvent ---
    def closeEvent(self, event):
        """
        当用户尝试关闭窗口时，此方法被调用。
        """
        # 创建一个提问对话框
        reply = QMessageBox.question(
            self, 
            '确认退出', 
            '你确定要退出吗？', 
            QMessageBox.Yes | QMessageBox.No | QMessageBox.Cancel, 
            QMessageBox.No  # 默认选择 "No"
        )
        if reply == QMessageBox.Yes:
            # 用户点击 "Yes"，接受关闭事件
            print("用户选择关闭。")
            event.accept()
        elif reply == QMessageBox.Cancel:
            # 用户点击 "Cancel"，忽略关闭事件
            print("用户取消关闭。")
            event.ignore()
        else:
            # 用户点击 "No"，也忽略关闭事件
            print("用户选择不关闭。")
            event.ignore()
if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec_())

代码解析：

1. 我们创建了一个继承自 QMainWindow 的 MainWindow 类。
2. 核心在于 closeEvent(self, event) 方法。
3. 当窗口关闭时，QMessageBox.question 会弹出一个带有 "是"、"否" 和 "取消" 按钮的对话框。
4. 我们根据用户的返回值 (reply) 来决定是调用 event.accept()（允许关闭）还是 event.ignore()（阻止关闭）。

关闭前保存数据

这个场景与场景一非常相似，只是逻辑判断的条件不同，如果数据有未保存的更改,我们就阻止关闭。

import sys
from PyQt5.QtWidgets import (QApplication, QMainWindow, QMessageBox, 
                             QTextEdit, QVBoxLayout, QWidget)
class EditorWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("文本编辑器")
        self.setGeometry(300, 300, 500, 400)
        self.text_edit = QTextEdit()
        self.setCentralWidget(self.text_edit)
        # 用于跟踪文本是否被修改
        self.document().contentsChanged.connect(self.set_modified)
        self._is_modified = False
    def set_modified(self):
        """当文档内容改变时，标记为已修改"""
        self._is_modified = True
    def is_window_modified(self):
        """返回窗口是否被修改"""
        return self._is_modified
    def closeEvent(self, event):
        """
        如果文档有未保存的更改，则提示用户。
        """
        if self.is_window_modified():
            reply = QMessageBox.question(
                self, 
                '未保存的更改', 
                '文档已被修改，是否保存并退出？', 
                QMessageBox.Save | QMessageBox.Discard | QMessageBox.Cancel,
                QMessageBox.Save
            )
            if reply == QMessageBox.Save:
                # 在这里添加保存文件的逻辑
                print("保存文件...")
                # 假设保存成功
                self._is_modified = False
                event.accept()
            elif reply == QMessageBox.Discard:
                # 用户选择不保存，直接退出
                print("不保存，直接退出。")
                event.accept()
            else: # Cancel
                # 用户取消操作
                print("取消退出。")
                event.ignore()
        else:
            # 如果没有修改，直接关闭
            print("文档未修改，直接关闭。")
            event.accept()
if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = EditorWindow()
    window.show()
    sys.exit(app.exec_())

代码解析：

1. 我们使用一个 QTextEdit 作为文本编辑区。
2. 通过连接 contentsChanged 信号，我们可以在文本被修改时设置一个标志 _is_modified。
3. 在 closeEvent 中，我们检查 _is_modified 的状态。
4. 如果为 True，则弹出保存提示，并根据用户的选择（保存、放弃、取消）来决定是否关闭窗口。

最小化到系统托盘

这是一个更高级的用法，当用户点击关闭按钮时，我们不关闭窗口，而是将其隐藏，并创建一个图标在系统托盘（任务栏右下角或屏幕右上角）中,用户可以通过双击托盘图标来恢复窗口。

注意: 这个例子需要额外的库来创建系统托盘图标。PyQt5 和 PySide6 内置了 QSystemTrayIcon,非常方便。

import sys
from PyQt5.QtWidgets import (QApplication, QMainWindow, QSystemTrayIcon, 
                             QMenu, QAction, QMessageBox)
from PyQt5.QtGui import QIcon
from PyQt5.QtCore import Qt
class TrayIconApp(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("最小化到托盘")
        self.setGeometry(300, 300, 400, 200)
        # 1. 创建系统托盘图标
        self.tray_icon = QSystemTrayIcon(self)
        # 你需要一个图标文件，或者使用一个内置的
        # self.tray_icon.setIcon(QIcon("path/to/your/icon.png")) 
        # 如果没有图标文件，可以使用一个简单的图标
        self.tray_icon.setIcon(self.style().standardIcon(QApplication.SP_ComputerIcon))
        # 2. 创建托盘菜单
        tray_menu = QMenu()
        show_action = QAction("显示窗口", self)
        show_action.triggered.connect(self.show)
        quit_action = QAction("退出", self)
        quit_action.triggered.connect(self.quit_app)
        tray_menu.addAction(show_action)
        tray_menu.addAction(quit_action)
        self.tray_icon.setContextMenu(tray_menu)
        self.tray_icon.show()
        # 连接托盘图标的双击事件
        self.tray_icon.activated.connect(self.on_tray_icon_activated)
    def on_tray_icon_activated(self, reason):
        """处理托盘图标点击事件"""
        if reason == QSystemTrayIcon.DoubleClick:
            if self.isVisible():
                self.hide()
            else:
                self.show()
                self.raise_()
                self.activateWindow()
    def closeEvent(self, event):
        """
        重写关闭事件，隐藏窗口而不是关闭它。
        """
        print("窗口即将关闭，但我们将隐藏它。")
        self.hide()  # 隐藏窗口
        event.ignore()  # 忽略关闭事件，阻止窗口真正关闭
    def quit_app(self):
        """
        退出应用程序的槽函数。
        """
        print("用户选择退出。")
        self.tray_icon.hide() # 先隐藏托盘图标
        QApplication.quit() # 然后退出整个应用
if __name__ == '__main__':
    app = QApplication(sys.argv)
    # 必须设置一个图标才能在 macOS 和 Linux 上显示托盘图标
    app.setWindowIcon(QIcon.fromTheme("computer"))
    window = TrayIconApp()
    window.show()
    sys.exit(app.exec_())

代码解析：

1. 创建 QSystemTrayIcon: 这是实现托盘功能的核心。
2. 设置图标和菜单: 为托盘图标设置一个图标和一个右键菜单，菜单包含“显示窗口”和“退出”选项。
3. 重写 closeEvent: 当用户点击窗口的 'X' 时，我们不接受关闭事件，而是调用 self.hide() 将窗口隐藏到后台，然后调用 event.ignore() 阻止程序退出。
4. 退出逻辑: 我们提供一个明确的“退出”操作（在托盘菜单中），它会调用 QApplication.quit() 来安全地终止整个应用程序。

重写 closeEvent 是实现优雅、健壮的桌面应用程序的关键一环，掌握它能让你更好地控制应用程序的生命周期,提供更好的用户体验。