PyQt5 EventFilter无法检测按键按下事件问题求助

问题原因 #

1. QMainWindow本身不接收键盘焦点：键盘事件默认传递给窗口内拥有焦点的子部件（如central widget），直接给QMainWindow安装事件过滤器无法捕获KeyPress事件。
2. 原代码遗漏窗口显示：未调用window.show()，窗口未激活自然无法接收任何事件。
3. 初始化参数异常：Ui(0.1)不符合QMainWindow的初始化规范，可能导致窗口初始化异常。

修正方案1：使用事件过滤器捕获子部件的KeyPress事件 #

import sys
from PyQt5 import QtCore, QtWidgets

class Ui(QtWidgets.QMainWindow):
    def __init__(self):
        super().__init__()
        # 创建central widget作为焦点承载部件
        self.central_widget = QtWidgets.QWidget()
        self.setCentralWidget(self.central_widget)
        # 设置部件可获取焦点
        self.central_widget.setFocusPolicy(QtCore.Qt.StrongFocus)
        # 给central widget安装事件过滤器
        self.central_widget.installEventFilter(self)

    def eventFilter(self, obj, event):
        # 仅处理central widget的KeyPress事件
        if obj == self.central_widget and event.type() == QtCore.QEvent.KeyPress:
            print(f"按键码：{event.key()}，按键文本：{event.text()}")
            # 返回True可拦截事件，返回False允许事件继续传递
            return False
        return super().eventFilter(obj, event)

if __name__ == "__main__":
    app = QtWidgets.QApplication(sys.argv)
    window = Ui()
    window.show()  # 必须显示窗口
    app.exec_()

修正方案2：直接重写keyPressEvent方法 #

如果只需要处理窗口级别的键盘事件，重写keyPressEvent比事件过滤器更直接：

import sys
from PyQt5 import QtCore, QtWidgets

class Ui(QtWidgets.QMainWindow):
    def __init__(self):
        super().__init__()
        self.central_widget = QtWidgets.QWidget()
        self.setCentralWidget(self.central_widget)
        self.central_widget.setFocusPolicy(QtCore.Qt.StrongFocus)

    def keyPressEvent(self, event):
        print(f"按键码：{event.key()}，按键文本：{event.text()}")
        # 调用父类方法保证事件正常传递
        super().keyPressEvent(event)

if __name__ == "__main__":
    app = QtWidgets.QApplication(sys.argv)
    window = Ui()
    window.show()
    app.exec_()

关键注意事项 #

• 必须给窗口内的部件设置StrongFocus焦点策略，确保其能接收键盘事件。
• 事件过滤器需安装在实际接收焦点的部件上，而非QMainWindow本身。
• 窗口必须调用show()方法激活，否则无法获取任何输入事件。

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