PyQt5中如何根据用户所选语言分配QShortcut快捷键

问题场景 #

当用户选择泰米尔语作为系统输入语言、使用Tamil99键盘布局时，按照布局映射规则，物理按键Key_A对应泰米尔字符அ，需要实现快捷键序列Alt+அ的响应逻辑，现有测试代码如下：

# 直接传入泰米尔字符的写法无法生效
#mykey = QShortcut(QKeySequence(Alt+அ), self)
# 绑定物理A键的写法无法适配多语言布局的显示和键位匹配
mykey = QShortcut(QKeySequence(Alt+A), self)
mykey.activated.connect(self.func_keysequence_process)

实现方案 #

Qt的快捷键匹配逻辑默认基于**物理按键的底层键值（Qt::Key枚举）**触发，和输入法映射后的输出字符没有直接关联，直接传入非拉丁字符构造QKeySequence会因为无法解析键值导致绑定失效，按以下步骤实现即可：

• 查询当前布局下目标字符对应的物理键值
  不要硬编码固定的物理按键（比如永远绑Key_A），通过Qt提供的按键映射接口，查询当前激活的键盘布局下，目标本地化字符对应的底层物理键值，示例代码：

  from PyQt5.QtCore import Qt, QEvent
  from PyQt5.QtGui import QGuiApplication, QKeySequence
  from PyQt5.QtWidgets import QShortcut
  
  def get_mapped_key(target_char: str) -> int:
      """查询当前键盘布局下，目标字符对应的物理键值"""
      key_map = QGuiApplication.keymap()
      # 遍历主键区可打印字符对应的键值范围做匹配
      for key_code in range(Qt.Key_Space, Qt.Key_AsciiTilde + 1):
          if key_map.keyToString(key_code) == target_char:
              return key_code
      return 0
  

• 绑定快捷键并设置本地化显示文本
  拿到对应物理键值后，拼接修饰键构造快捷键对象，同时手动指定快捷键的显示文本，避免Qt默认显示物理键的英文字符：

  # 查询泰米尔字符அ对应的当前布局物理键
  target_key = get_mapped_key("அ")
  if target_key:
      shortcut = QShortcut(QKeySequence(Qt.AltModifier | target_key), self)
      # 手动设置本地化的快捷键显示文本，适配UI多语言需求
      shortcut.setWhatsThis("Alt+அ")
      shortcut.activated.connect(self.func_keysequence_process)
  

• 适配键盘布局动态切换
  如果需要支持用户运行时切换输入语言/键盘布局，重写窗口的changeEvent事件，捕获布局切换事件后重新查询键值、更新快捷键绑定即可：

  def changeEvent(self, event):
      if event.type() == QEvent.KeyboardLayoutChange:
          # 键盘布局变化后重新绑定快捷键
          self.update_shortcut_mapping()
      super().changeEvent(event)
  

注意：Qt 5.x版本对非拉丁字符直接构造QKeySequence的兼容性很差，必须先映射到物理键值再做绑定，不要直接把本地化字符传入QKeySequence构造函数。

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