PyQt / PySide 特定部件的键盘快捷键

在本文中，我们将介绍如何为 PyQt 或 PySide 应用程序中的特定部件设置键盘快捷键。键盘快捷键是用户在使用应用程序时可以通过按下特定键组合来快速触发特定操作或命令的功能。

阅读更多：PyQt 教程

键盘事件处理

在 PyQt 或 PySide 中，可以使用 keyPressEvent 和 keyReleaseEvent 方法来处理键盘事件。这两个方法继承自 QWidget 类，因此可以在任何部件中重写这些方法来实现特定部件的键盘快捷键。

以下是一个简单的示例，演示了如何为一个按钮设置键盘快捷键，当用户按下 “Ctrl + S” 时触发点击按钮的操作：

from PyQt5.QtWidgets import QApplication, QWidget, QPushButton
from PyQt5.QtGui import QKeySequence
from PyQt5.QtCore import Qt

class MyWidget(QWidget):
    def __init__(self):
        super().__init__()
        self.initUI()

    def initUI(self):
        self.setWindowTitle('Keyboard Shortcut Example')
        self.setGeometry(300, 300, 300, 200)

        self.button = QPushButton('Save', self)
        self.button.setShortcut(QKeySequence(Qt.CTRL + Qt.Key_S))
        self.button.clicked.connect(self.onButtonClicked)

    def onButtonClicked(self):
        # 处理按钮点击事件
        print('Button clicked!')

    def keyPressEvent(self, event):
        if event.modifiers() == Qt.ControlModifier and event.key() == Qt.Key_S:
            self.button.click()

if __name__ == '__main__':
    app = QApplication([])
    widget = MyWidget()
    widget.show()
    app.exec_()

在上面的示例中，我们创建了一个自定义的 QWidget 子类 MyWidget，并在 initUI 方法中创建了一个 QPushButton。我们通过调用 setShortcut 方法为按钮设置了 “Ctrl + S” 的键盘快捷方式。然后，我们将按钮的 clicked 信号连接到 onButtonClicked 方法，以便在按钮被点击时触发相应的操作。

同时，我们还重写了部件的 keyPressEvent 方法，监控用户的键盘事件。当用户按下 “Ctrl + S” 时，我们使用 self.button.click() 隐式触发了按钮的点击事件，从而实现了键盘快捷键的效果。

部件的焦点

上述示例中的键盘快捷键只能在按钮处于焦点状态时才起作用。因此，部件的焦点管理对于键盘快捷键的响应至关重要。

在 PyQt 或 PySide 中，可以使用 setFocusPolicy 方法来设置部件的焦点策略。焦点策略可以是以下之一：

Qt.NoFocus：部件从不获得焦点。
Qt.TabFocus：通过按 Tab 键可以将焦点移动到部件上。
Qt.ClickFocus：通过鼠标单击操作可以将焦点移动到部件上。
Qt.StrongFocus：通过按 Tab 键或鼠标单击操作都可以将焦点移动到部件上。

以下是一个示例，演示了如何为一个文本框设置键盘快捷键，并在没有焦点时依然能响应快捷键。

from PyQt5.QtWidgets import QApplication, QWidget, QLineEdit
from PyQt5.QtGui import QKeySequence
from PyQt5.QtCore import Qt

class MyWidget(QWidget):
    def __init__(self):
        super().__init__()
        self.initUI()

    def initUI(self):
        self.setWindowTitle('Keyboard Shortcut Example')
        self.setGeometry(300, 300, 300, 200)

        self.lineEdit = QLineEdit(self)
        self.lineEdit.setPlaceholderText('Type something...')
        self.lineEdit.setFocusPolicy(Qt.StrongFocus)
        self.lineEdit.setShortcut(QKeySequence(Qt.ControlModifier + Qt.Key_E))

    def keyPressEvent(self, event):
        if event.modifiers() == Qt.ControlModifier and event.key() == Qt.Key_E:
            print('Shortcut triggered!')

if __name__ == '__main__':
    app = QApplication([])
    widget = MyWidget()
    widget.show()
    app.exec_()

在上面的示例中，我们创建了一个包含一个文本框的自定义部件 MyWidget。我们通过调用 setFocusPolicy(Qt.StrongFocus) 方法将焦点策略设置为 Qt.StrongFocus，这样即使文本框没有焦点，它仍然能够响应键盘快捷键。

同时，我们为文本框设置了 “Ctrl + E” 的快捷键，当用户按下该组合键时，keyPressEvent 方法会被触发，打印出相应的消息。