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

原文參考：偵測鍵盤事件與快速鍵組合

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

偵測按下鍵盤的按鍵

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

from PyQt5 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(0,0,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_())

PyQt5 keycode 對照表

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

偵測鍵盤快速鍵組合

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

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

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

from PyQt5 import QtWidgets
from PyQt5.QtGui import QKeySequence
import sys

app = QtWidgets.QApplication(sys.argv)

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

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

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

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

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

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


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

更多 Python 教學

大家好，我是 OXXO，是個即將邁入中年的斜槓青年，我已經寫了超過 400 篇 Python 的教學，有興趣可以參考下方連結呦～ ^_^

• Python 教學 ( 學習導讀 )
• Python 網路爬蟲教學
• LINE BOT 教學
• OpenCV 教學
• AI 影像辨識教學