介绍

在 PySide2 中，处理“失去焦点事件”（focusOutEvent）主要有 3 种核心实现方法，适用于不同场景。以下是详细说明和对比：

方法 1：重写控件自身的 focusOutEvent 方法（最常用）

通过继承目标控件（如 QLineEdit、QWidget 等），重写其 focusOutEvent 方法，直接在控件内部处理失去焦点逻辑。

适用场景：

• 需要在多个地方复用相同的失去焦点逻辑（如自定义输入框）。
• 逻辑与控件本身强相关（如输入验证、样式变化）。

示例代码：

from PySide2.QtWidgets import QLineEdit, QApplication
from PySide2.QtGui import QFocusEvent

class MyLineEdit(QLineEdit):
    def focusOutEvent(self, event: QFocusEvent):
        # 1. 先调用父类方法，保留默认行为（必做！）
        super().focusOutEvent(event)

        # 2. 自定义逻辑：失去焦点时验证输入
        text = self.text().strip()
        if not text:
            self.setStyleSheet("border: 1px solid red;")
        else:
            self.setStyleSheet("")

# 使用自定义控件
app = QApplication([])
edit = MyLineEdit()
edit.show()
app.exec_()

方法 2：使用事件过滤器（Event Filter）

在父控件中实现 eventFilter 方法，监控目标控件的所有事件，当检测到“失去焦点事件”时进行处理。

适用场景：

• 临时处理某个控件的事件，不想修改控件本身（如第三方控件）。
• 需在父控件中集中管理多个子控件的事件。

示例代码：

from PySide2.QtWidgets import QWidget, QLineEdit, QVBoxLayout, QApplication
from PySide2.QtCore import QEvent

class ParentWidget(QWidget):
    def __init__(self):
        super().__init__()
        self.edit = QLineEdit(self)
        layout = QVBoxLayout(self)
        layout.addWidget(self.edit)

        # 给目标控件安装事件过滤器
        self.edit.installEventFilter(self)

    def eventFilter(self, watched, event):
        # 只处理目标控件的事件
        if watched == self.edit:
            # 检测失去焦点事件（QEvent.FocusOut）
            if event.type() == QEvent.FocusOut:
                # 自定义逻辑
                text = self.edit.text().strip()
                if not text:
                    self.edit.setStyleSheet("border: 1px solid red;")
                else:
                    self.edit.setStyleSheet("")
                return True  # 可选：返回True表示事件已处理，不再传递

        # 其他事件交给默认处理
        return super().eventFilter(watched, event)

app = QApplication([])
window = ParentWidget()
window.show()
app.exec_()

方法 3：使用 QApplication 的全局事件过滤器（全局监控）

通过给应用程序（QApplication）安装事件过滤器，监控所有控件的失去焦点事件，适合全局统一处理（如日志记录、全局焦点管理）。

适用场景：

• 需要监控整个应用中所有控件的焦点变化（如统计用户交互、全局样式管理）。
• 跨多个窗口的焦点逻辑处理。

示例代码：

from PySide2.QtWidgets import QApplication, QLineEdit, QWidget, QVBoxLayout
from PySide2.QtCore import QEvent

class GlobalFocusMonitor(QWidget):
    def __init__(self):
        super().__init__()
        self.edit1 = QLineEdit()
        self.edit2 = QLineEdit()
        layout = QVBoxLayout(self)
        layout.addWidget(self.edit1)
        layout.addWidget(self.edit2)

        # 给应用程序安装全局事件过滤器
        QApplication.instance().installEventFilter(self)

    def eventFilter(self, watched, event):
        # 监控所有控件的失去焦点事件
        if event.type() == QEvent.FocusOut:
            # 输出失去焦点的控件信息
            print(f"控件 {watched.objectName()} 失去焦点")
            # 可根据控件类型或名称添加自定义逻辑
            if isinstance(watched, QLineEdit):
                if not watched.text().strip():
                    watched.setStyleSheet("border: 1px solid red;")
                else:
                    watched.setStyleSheet("")

        return super().eventFilter(watched, event)

app = QApplication([])
window = GlobalFocusMonitor()
window.show()
app.exec_()

三种方法对比

总结

• 优先用 方法 1（重写事件）：控件逻辑内聚，适合自定义控件。
• 次选用 方法 2（控件过滤器）：临时处理单个控件，无需修改控件类。
• 慎用 方法 3（全局过滤器）：仅在需要全局监控时使用，避免过度消耗资源。

三种方法的核心都是捕获 QEvent.FocusOut 事件，区别在于事件处理的范围和代码组织方式。

原文出处：/show_1GW1sz0wSA1B.html