PyQt5中如何保留隐藏部件的快捷键？

这个场景我太熟悉了——想在全屏模式下隐藏菜单栏，但又不想丢掉那些常用的快捷键功能。其实问题出在PyQt的快捷键绑定逻辑上：默认情况下，QAction的快捷键只有当它所在的父部件（这里就是菜单栏）可见时，才会被系统识别和处理。隐藏菜单栏后，这个载体没了，快捷键自然就失效了。不过有几个简单的办法能搞定：

方法一：将QAction直接添加到主窗口 #

最直接的解决方案就是把你的功能动作不仅添加到菜单里，同时也添加到主窗口本身。这样主窗口会成为快捷键的监听载体，不管菜单是否隐藏，都能响应快捷键。

修改你的示例代码如下：

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QAction

class Window(QMainWindow):
    def __init__(self):
        super().__init__()
        self.InitWindow()

    def InitWindow(self):
        mainMenu = self.menuBar()
        fileMenu = mainMenu.addMenu("&File")
        
        quitItem = QAction("Quit", self)
        quitItem.setShortcut("Q")
        quitItem.triggered.connect(self.close)
        fileMenu.addAction(quitItem)
        
        # 关键步骤：把动作注册到主窗口
        self.addAction(quitItem)
        
        mainMenu.hide()  # 现在隐藏菜单后，按Q依然能退出应用

if __name__ == "__main__":
    App = QApplication(sys.argv)
    window = Window()
    window.show()
    sys.exit(App.exec())

这样修改后，即使菜单栏被隐藏，主窗口会一直监听quitItem的快捷键，完全不影响功能。

方法二：使用QShortcut独立绑定快捷键 #

如果不想依赖QAction的菜单关联，也可以直接用QShortcut来单独绑定快捷键，这种方式更灵活，完全和菜单无关。

示例代码如下：

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QAction
from PyQt5.QtGui import QKeySequence
from PyQt5.QtWidgets import QShortcut

class Window(QMainWindow):
    def __init__(self):
        super().__init__()
        self.InitWindow()

    def InitWindow(self):
        mainMenu = self.menuBar()
        fileMenu = mainMenu.addMenu("&File")
        
        quitItem = QAction("Quit", self)
        quitItem.triggered.connect(self.close)
        fileMenu.addAction(quitItem)
        
        # 创建独立的快捷键绑定
        quit_shortcut = QShortcut(QKeySequence("Q"), self)
        quit_shortcut.activated.connect(self.close)
        
        mainMenu.hide()

if __name__ == "__main__":
    App = QApplication(sys.argv)
    window = Window()
    window.show()
    sys.exit(App.exec())

这种方式适合那些不需要在菜单中显示，但需要快捷键的功能，或者你想完全分离菜单和快捷键逻辑的场景。

针对全屏场景的优化 #

如果你要实现全屏时隐藏菜单、恢复时显示的功能，可以扩展一下代码，添加全屏切换的逻辑，同时确保快捷键全程有效：

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QAction

class Window(QMainWindow):
    def __init__(self):
        super().__init__()
        self.InitWindow()

    def InitWindow(self):
        mainMenu = self.menuBar()
        fileMenu = mainMenu.addMenu("&File")
        
        # 退出动作
        quitItem = QAction("Quit", self)
        quitItem.setShortcut("Q")
        quitItem.triggered.connect(self.close)
        fileMenu.addAction(quitItem)
        self.addAction(quitItem)
        
        # 全屏切换动作
        fullscreenItem = QAction("Toggle Full Screen", self)
        fullscreenItem.setShortcut("F11")
        fullscreenItem.triggered.connect(self.toggleFullScreen)
        fileMenu.addAction(fullscreenItem)
        self.addAction(fullscreenItem)
        
        # 默认隐藏菜单，或者根据需求调整
        mainMenu.hide()

    def toggleFullScreen(self):
        if self.isFullScreen():
            self.showNormal()
            self.menuBar().show()
        else:
            self.showFullScreen()
            self.menuBar().hide()

if __name__ == "__main__":
    App = QApplication(sys.argv)
    window = Window()
    window.show()
    sys.exit(App.exec())

这样切换全屏时，菜单会自动隐藏/显示，而快捷键（Q退出、F11切换全屏）在任何状态下都能正常工作。

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