在 qt（pyqt/pyside）中，可通过 qfocusevent.reason() 获取焦点获取原因，精准区分 tab 切换、鼠标点击、程序调用等不同场景，从而实现“仅在按 tab 键时触发自动填充”的业务逻辑。
在 qt（pyqt/pyside）中，可通过 qfocusevent.reason() 获取焦点获取原因，精准区分 tab 切换、鼠标点击、程序调用等不同场景，从而实现“仅在按 tab 键时触发自动填充”的业务逻辑。
在构建表单类 UI（如用户注册、数据录入界面）时，常需根据用户操作上下文智能填充字段。例如：当用户按 Tab 从“序号1”跳转到“序号2”输入框时，自动填入 int(前一个值) + 1；但若用户直接鼠标点击“序号2”，则不应覆盖其手动输入意图。这种行为差异的关键，在于识别焦点变更的触发方式。
Qt 提供了完备的机制支持该需求：QFocusEvent（即 event.type() == QEvent.FocusIn 时传入的 event 对象）包含 reason() 方法，返回一个 Qt.FocusReason 枚举值。常用取值包括：
- Qt.TabFocusReason：由 Tab 或 Shift+Tab 键触发
- Qt.MouseFocusReason：由鼠标点击获得焦点
- Qt.ActiveWindowFocusReason：窗口被激活时获得焦点
- Qt.OtherFocusReason：其他方式（如 setFocus() 调用）
因此，只需在事件过滤器中增加对 event.reason() 的判断即可精准控制逻辑分支：
from PyQt5.QtCore import Qt, QEvent
from PyQt5.QtWidgets import QLineEdit, QApplication, QWidget, QVBoxLayout
class AutoFillForm(QWidget):
def __init__(self):
super().__init__()
self.previous_input = None
self.init_ui()
def init_ui(self):
layout = QVBoxLayout()
self.line1 = QLineEdit()
self.line2 = QLineEdit()
self.line3 = QLineEdit()
for le in [self.line1, self.line2, self.line3]:
le.installEventFilter(self)
layout.addWidget(le)
self.setLayout(layout)
def eventFilter(self, watched: QLineEdit, event: QEvent) -> bool:
if event.type() == QEvent.FocusIn:
# ✅ 仅当是 Tab 切换且目标为空时执行自动填充
if (isinstance(event, QFocusEvent) and
event.reason() == Qt.TabFocusReason and
self.previous_input is not None and
watched.text().strip() == ""):
try:
prev_val = int(self.previous_input.text().strip())
watched.setText(str(prev_val + 1))
except ValueError:
pass # 忽略非数字内容，不中断流程
self.previous_input = watched
return super().eventFilter(watched, event)⚠️ 注意事项：
- event.reason() 仅对 QFocusEvent 类型有效，务必先确认 isinstance(event, QFocusEvent) 或至少确保 event.type() == QEvent.FocusIn；
- Qt.TabFocusReason 同样涵盖反向 Tab（Shift+Tab），无需额外处理；
- 若使用 PySide6，请导入 PySide6.QtCore.Qt 并注意枚举路径一致（Qt.FocusReason.TabFocusReason）；
- 避免在 eventFilter 中执行耗时操作（如网络请求），否则会阻塞 UI 响应；
- self.previous_input 应始终指向上一个获得焦点的控件，而非逻辑上的“前一字段”，因此建议在每次 FocusIn 时更新，而非依赖控件顺序。
总结而言，QFocusEvent.reason() 是 Qt 提供的轻量、可靠且语义明确的焦点溯源工具。它让开发者摆脱对键盘事件监听（如 keyPressEvent）或状态标记的复杂维护，以声明式方式实现上下文感知的交互逻辑——这正是专业 Qt 表单开发中“精准响应用户意图”的关键实践。
