如何在Shift组合键中获取底层基础键？PyQt6热键自定义需求

问题背景 #

在PyQt6中实现自定义热键输入框时，遇到Shift组合键显示异常：按下Shift+2时，输入框显示Shift+@而非预期的Shift+2。尝试用nativeVirtualKey()处理后，字母数字键显示正常，但其他键（如逗号、单引号）在Win10美式键盘下会显示¼、Þ这类异常字符，且对nativeVirtualKey()的定义不明确。现有自定义QLineEdit代码如下：

from PyQt6.QtWidgets import QApplication, QLineEdit
from PyQt6.QtGui import QKeyEvent, QKeySequence
from PyQt6.QtCore import Qt, QKeyCombination

class HKLineEdit(QLineEdit):
    modifiers = {16777248, 16777249, 16777250, 16777251}

    def keyPressEvent(self, event: QKeyEvent):
        if event.isAutoRepeat():
            return
        if event.key() in self.modifiers:
            return
        
        seq = QKeySequence(event.keyCombination())
        self.setText(seq.toString())

        # alternative with native virtual key:
        mods = Qt.KeyboardModifier(event.modifiers())
        nv_key = Qt.Key(event.nativeVirtualKey())
        seq = QKeySequence(QKeyCombination(mods, nv_key))
        self.setText(seq.toString())

app = QApplication([])
window = HKLineEdit()
window.show()
app.exec()

解决方案 #

核心思路是基于Qt标准键枚举获取物理键位标识，而非依赖系统返回的输入字符，同时针对Shift组合的符号键做映射处理，实现跨平台、跨区域的正确显示。

修改后的代码 #

from PyQt6.QtWidgets import QApplication, QLineEdit
from PyQt6.QtGui import QKeyEvent, QKeySequence
from PyQt6.QtCore import Qt, QKeyCombination

class HKLineEdit(QLineEdit):
    # 用Qt标准修饰键枚举替代硬编码数值，提升跨平台兼容性与可读性
    MODIFIER_KEYS = {
        Qt.Key.Key_Shift, Qt.Key.Key_Control, Qt.Key.Key_Alt, Qt.Key.Key_Meta
    }

    def keyPressEvent(self, event: QKeyEvent):
        if event.isAutoRepeat():
            return
        
        key = event.key()
        # 单独按下修饰键时不做处理
        if key in self.MODIFIER_KEYS:
            return
        
        # 获取当前修饰键状态，构建标准键组合
        modifiers = event.modifiers()
        key_comb = QKeyCombination(modifiers, Qt.Key(key))
        # 使用NativeText格式生成符合系统习惯的显示字符串
        key_str = QKeySequence(key_comb).toString(QKeySequence.SequenceFormat.NativeText)
        
        # Shift组合符号键的映射表：将系统返回的符号替换为物理键位
        shift_key_mapping = {
            Qt.Key.Key_Exclam: "1", Qt.Key.Key_At: "2", Qt.Key.Key_NumberSign: "3",
            Qt.Key.Key_Dollar: "4", Qt.Key.Key_Percent: "5", Qt.Key.Key_Caret: "6",
            Qt.Key.Key_Ampersand: "7", Qt.Key.Key_Asterisk: "8", Qt.Key.Key_ParenLeft: "9",
            Qt.Key.Key_ParenRight: "0", Qt.Key.Key_Underscore: "-", Qt.Key.Key_Plus: "=",
            Qt.Key.Key_BraceLeft: "[", Qt.Key.Key_BraceRight: "]", Qt.Key.Key_Bar: "\\",
            Qt.Key.Key_Colon: ";", Qt.Key.Key_Quote: "'", Qt.Key.Key_Less: ",",
            Qt.Key.Key_Greater: ".", Qt.Key.Key_Question: "/"
        }
        
        # 针对Shift组合键做替换处理
        if modifiers & Qt.KeyboardModifier.ShiftModifier and key in shift_key_mapping:
            parts = key_str.split("+")
            parts[-1] = shift_key_mapping[key]
            key_str = "+".join(parts)
        
        self.setText(key_str)

app = QApplication([])
window = HKLineEdit()
window.show()
app.exec()

关键优化点 #

• 用Qt标准Qt.Key枚举替代硬编码修饰键值，代码更易维护且跨平台
• 通过映射表将Shift+符号键的显示结果替换为对应的物理键位（如@→2）
• 使用NativeText格式生成字符串，保证不同平台下修饰键名称符合系统习惯（Windows显示Ctrl，Mac显示Command）

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