偵測鍵盤事件與快速鍵組合

這篇教學會介紹在 PyQt6 的視窗裡，偵測按下哪個鍵盤的按鍵，以及是否按下鍵盤的快速鍵 ( 熱鍵 ) 組合，透過鍵盤按鍵的事件，進行簡單的互動應用。

快速導覽：

• 偵測按下鍵盤的按鍵
• PyQt6 keycode 對照表
• 偵測鍵盤快速鍵組合

因為 Google Colab 不支援 PyQt6，所以請使用本機環境 ( 參考：使用 Python 虛擬環境 ) 或使用 Anaconda Jupyter 進行實作 ( 參考：使用 Anaconda )。

偵測按下鍵盤的按鍵

建立 PyQt6 的 Widget 元件之後，可以使用 keyPressEvent 偵測鍵盤按下事件，將事件對應到指定的函式，在函式內使用 key() 方法，就能取得鍵盤按鍵的 keycode，下方的程式碼執行後，會透過 QLabel 印出目前按下的鍵盤 keycode。

from PyQt6 import QtWidgets
import sys

app = QtWidgets.QApplication(sys.argv)

Form = QtWidgets.QWidget()
Form.setWindowTitle('oxxo.studio')
Form.resize(300, 200)

label = QtWidgets.QLabel(Form)
label.setGeometry(20,20,100,30)

def key(self):
    keycode = self.key()         # 取得該按鍵的 keycode
    label.setText(str(keycode))  # QLabel 印出 keycode

Form.keyPressEvent = key         # 建立按下鍵盤事件，對應到 key 函式

Form.show()
sys.exit(app.exec())

class 寫法：

from PyQt6 import QtWidgets
from PyQt6.QtGui import QEnterEvent
import sys

class MyWidget(QtWidgets.QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowTitle('oxxo.studio')
        self.resize(300, 200)
        self.setMouseTracking(True)
        self.ui()

    def ui(self):
        self.label = QtWidgets.QLabel(self)
        self.label.setGeometry(20,20,100,30)

    def keyPressEvent(self, event):
        keycode = event.key()             # 取得該按鍵的 keycode
        self.label.setText(str(keycode))  # QLabel 印出 keycode

if __name__ == '__main__':
    app = QtWidgets.QApplication(sys.argv)
    Form = MyWidget()
    Form.show()
    sys.exit(app.exec())

PyQt6 keycode 對照表

在 PyQt6 裡大部分的 keycode 都與標準 keycode 相同，例如 A～Z、0～9、特殊符號...等，然而像是 Enter、Del 等特殊鍵，則會出現比較不同的數值，下方列出常用按鍵的對照表。

偵測鍵盤快速鍵組合

如果要偵測鍵盤的快速鍵組合 ( 熱鍵 )，例如 Ctrl+O、Ctrl+C...等，除了自己寫程式判斷，也可以載入 PyQt6.QtGui 的 QKeySequence 模組搭配 QShortcut() 方法，就可以偵測快速鍵 ( 方法位置和 PyQt5 不同 )，使用方法如下：

shortcut = QtWidgets.QShortcut(QKeySequence("快速鍵組合"), Form)
shortcut.activated.connect(fn)
# Form 為主視窗元件
# 快速鍵組合例如 Ctrl+C、Alt+C...等，不可以有空格，不區分大小寫
# fn 為按下快速鍵組合要執行的函式

下方的程式碼執行後，當使用者按下快速鍵組合，就會透過 QLabel 顯示目前的快速鍵組合內容。

from PyQt6 import QtWidgets
from PyQt6.QtGui import QKeySequence, QShortcut
import sys

app = QtWidgets.QApplication(sys.argv)

Form = QtWidgets.QWidget()
Form.setWindowTitle('oxxo.studio')
Form.resize(300, 200)

label = QtWidgets.QLabel(Form)
label.setGeometry(20,20,100,30)

def ctrl_o():
    label.setText('Ctrl + O')

shortcut1 = QShortcut(QKeySequence("Ctrl+O"), Form)  # 偵測 Ctrl + O
shortcut1.activated.connect(ctrl_o)

def alt_shift_c():
    label.setText('Alt + Shift + C')

shortcut2 = QShortcut(QKeySequence("Alt+Shift+C"), Form)  # 偵測 Alt + Shift + C
shortcut2.activated.connect(alt_shift_c)


Form.show()
sys.exit(app.exec())

class 的寫法：

from PyQt6 import QtWidgets
from PyQt6.QtGui import QKeySequence, QShortcut
import sys

class MyWidget(QtWidgets.QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowTitle('oxxo.studio')
        self.resize(300, 200)
        self.setMouseTracking(True)
        self.ui()

    def ui(self):
        self.label = QtWidgets.QLabel(self)
        self.label.setGeometry(20,20,100,30)

        shortcut1 = QShortcut(QKeySequence("Ctrl+O"), self)  # 偵測 Ctrl + O
        shortcut1.activated.connect(self.ctrl_o)

        shortcut2 = QShortcut(QKeySequence("Alt+Shift+C"), self)  # 偵測 Alt + Shift + C
        shortcut2.activated.connect(self.alt_shift_c)

    def ctrl_o(self):
        self.label.setText('Ctrl + O')

    def alt_shift_c(self):
        self.label.setText('Alt + Shift + C')

if __name__ == '__main__':
    app = QtWidgets.QApplication(sys.argv)
    Form = MyWidget()
    Form.show()
    sys.exit(app.exec())

意見回饋

如果有任何建議或問題，可傳送「意見表單」給我，謝謝～