python pyside2 line edit单行文本输入控件（QLineEdit）失去焦点事件-马育民老师

# 介绍

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

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

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

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

#### 示例代码：
```python
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` 方法，监控目标控件的所有事件，当检测到“失去焦点事件”时进行处理。

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

#### 示例代码：
```python
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`）安装事件过滤器，监控**所有控件**的失去焦点事件，适合全局统一处理（如日志记录、全局焦点管理）。

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

#### 示例代码：
```python
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_()
```

### 三种方法对比
| 实现方法                | 核心 API                          | 适用范围               | 优点                                  | 缺点                                  |
|-------------------------|-----------------------------------|------------------------|---------------------------------------|---------------------------------------|
| 重写 `focusOutEvent`    | 继承控件并重写方法                | 单个控件或其派生类     | 逻辑封装在控件内部，复用性好          | 需要创建自定义控件类，不适合临时修改  |
| 控件事件过滤器          | `installEventFilter` + `eventFilter` | 单个或多个子控件       | 无需修改控件本身，灵活度高            | 逻辑分散在父控件中，多控件时易混乱    |
| 全局事件过滤器          | `QApplication.installEventFilter` | 整个应用所有控件       | 全局统一管理，适合跨窗口监控          | 可能影响性能，需精准判断事件目标      |

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

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

原文出处：http://malaoshi.top/show_1GW1sz0wSA1B.html