PyQt5带按键控制的透明窗口问题：特定按键无法捕获

嘿，我来帮你搞定这个问题！你遇到的情况是因为设置了WA_TransparentForMouseEvents之后，窗口默认会失去对键盘事件的响应权限——Qt觉得这种“对鼠标透明”的窗口不需要交互，所以连键盘事件也一起忽略了。不过别担心，咱们有两种靠谱的方法来解决这个问题：

方法一：调整焦点策略并重写按键事件 #

这种方法适合让窗口自身捕获按键，需要先让窗口能够获取焦点，再重写keyPressEvent方法来监听特定按键。修改后的完整代码如下：

import sys
from PyQt5 import QtCore, QtWidgets, QtGui

class QtWindow(QtWidgets.QWidget):
    def __init__(self):
        super().__init__()
        screen = QtWidgets.QApplication.primaryScreen()
        size = screen.size()
        w = size.width()
        h = size.height()

        self.resize(w, h)
        self.setWindowTitle('Custom Example')
        self.setAttribute(QtCore.Qt.WA_TransparentForMouseEvents, True)
        self.setAttribute(QtCore.Qt.WA_TranslucentBackground, True)
        self.setWindowFlags(QtCore.Qt.WindowStaysOnTopHint |
                            QtCore.Qt.FramelessWindowHint)
        # 设置强焦点策略，让窗口能获取键盘焦点
        self.setFocusPolicy(QtCore.Qt.StrongFocus)

    def keyPressEvent(self, event):
        # 捕获Q键来退出程序
        if event.key() == QtCore.Qt.Key_Q:
            QtWidgets.QApplication.quit()
        # 其他按键交给父类处理（也可以直接忽略）
        else:
            super().keyPressEvent(event)

if __name__ == '__main__':
    DR = QtWidgets.QApplication(sys.argv)
    window = QtWindow()
    window.show()
    sys.exit(DR.exec_())

方法二：使用全局事件过滤器 #

如果窗口因为焦点问题还是无法捕获按键，那就用全局事件过滤器——它能监听整个应用的所有事件，不管窗口是否在前台都能捕获到目标按键。代码示例：

import sys
from PyQt5 import QtCore, QtWidgets, QtGui

class KeyFilter(QtCore.QObject):
    def eventFilter(self, obj, event):
        # 监听按键按下事件
        if event.type() == QtCore.QEvent.KeyPress:
            # 捕获Q键退出
            if event.key() == QtCore.Qt.Key_Q:
                QtWidgets.QApplication.quit()
                return True  # 标记事件已处理，不再传递
        # 其他事件交给父类处理
        return super().eventFilter(obj, event)

class QtWindow(QtWidgets.QWidget):
    def __init__(self):
        super().__init__()
        screen = QtWidgets.QApplication.primaryScreen()
        size = screen.size()
        w = size.width()
        h = size.height()

        self.resize(w, h)
        self.setWindowTitle('Custom Example')
        self.setAttribute(QtCore.Qt.WA_TransparentForMouseEvents, True)
        self.setAttribute(QtCore.Qt.WA_TranslucentBackground, True)
        self.setWindowFlags(QtCore.Qt.WindowStaysOnTopHint |
                            QtCore.Qt.FramelessWindowHint)

if __name__ == '__main__':
    DR = QtWidgets.QApplication(sys.argv)
    # 创建并安装全局事件过滤器
    key_filter = KeyFilter()
    DR.installEventFilter(key_filter)
    
    window = QtWindow()
    window.show()
    sys.exit(DR.exec_())

小提示 #

• 方法一的优势是只让目标窗口处理按键，不会影响其他应用；
• 方法二更通用，适合窗口可能失去焦点的场景；
• 如果要捕获更多特定按键，只需要在按键判断里添加对应的QtCore.Qt.Key_XXX即可（比如Key_Escape代表ESC键）。

备注：内容来源于stack exchange，提问作者thehemen