如何在 PyQt6 中实现鼠标按键与字母/数字键的组合触发

本文介绍在 PyQt6 中检测鼠标按键（如左键）与普通键盘按键（如数字键 '1'）同时按下的方法，解决 QMouseEvent 不含 key() 方法的问题，通过状态标记+事件协同实现自定义组合操作。

本文介绍在 pyqt6 中检测鼠标按键（如左键）与普通键盘按键（如数字键 '1'）同时按下的方法，解决 `qmouseevent` 不含 `key()` 方法的问题，通过状态标记+事件协同实现自定义组合操作。

在 PyQt6（及兼容的 PySide6）中，QMouseEvent 对象（如 mousePressEvent 的参数）不提供 key() 方法——该方法仅存在于 QKeyEvent（如 keyPressEvent 的参数）中。因此，直接在鼠标事件中判断“是否按下了数字键 1”是不可行的，这也是你遇到 AttributeError: 'QMouseEvent' object has no attribute 'key' 的根本原因。

正确思路是：分离状态管理与事件响应。我们不依赖单次事件获取全部输入信息，而是用类属性持续跟踪鼠标按键状态（按下/释放），再在键盘事件中结合该状态判断组合动作。

✅ 实现步骤详解

定义状态标志：在窗口/控件类中声明布尔属性（如 self.lmb_pressed），初始为 False；
更新鼠标状态：在 mousePressEvent 中设为 True，在 mouseReleaseEvent 中设为 False；
组合逻辑判断：在 keyPressEvent 中，先检查 self.lmb_pressed 是否为 True，再判断 event.key() 值，从而识别“左键 + 数字1”等自定义组合；
注意事件传播：调用 super().xxxEvent(event) 保证父类默认行为（如焦点处理、样式更新）不受影响。

以下是完整、可运行的 PyQt6 示例代码（已适配 PyQt6 命名空间）：

from PyQt6.QtWidgets import QWidget, QApplication
from PyQt6.QtCore import Qt
from PyQt6.QtGui import QMouseEvent, QKeyEvent

class MyWidget(QWidget):
    def __init__(self):
        super().__init__()
        self.lmb_pressed = False  # 左键是否处于按下状态
        self.rmb_pressed = False  # 右键是否处于按下状态
        self.setFocusPolicy(Qt.FocusPolicy.StrongFocus)  # 确保能接收键盘事件

    def mousePressEvent(self, event: QMouseEvent):
        if event.button() == Qt.MouseButton.LeftButton:
            self.lmb_pressed = True
        elif event.button() == Qt.MouseButton.RightButton:
            self.rmb_pressed = True
        super().mousePressEvent(event)

    def mouseReleaseEvent(self, event: QMouseEvent):
        if event.button() == Qt.MouseButton.LeftButton:
            self.lmb_pressed = False
        elif event.button() == Qt.MouseButton.RightButton:
            self.rmb_pressed = False
        super().mouseReleaseEvent(event)

    def keyPressEvent(self, event: QKeyEvent):
        # 检测组合：左键按下时按数字1
        if self.lmb_pressed and event.key() == Qt.Key.Key_1:
            print("✅ 左键 + 数字键 '1' 同时按下")
            # 在此处添加你的业务逻辑，例如执行特定命令、切换模式等
            event.accept()  # 标记事件已处理，阻止进一步传播
            return

        # 检测组合：右键按下时按字母A
        if self.rmb_pressed and event.key() == Qt.Key.Key_A:
            print("✅ 右键 + 字母键 'A' 同时按下")

        # 单独按键处理（非组合）
        if event.key() == Qt.Key.Key_1:
            print("? 单独按下数字键 '1'")
        elif event.key() == Qt.Key.Key_Escape:
            self.close()

        super().keyPressEvent(event)

⚠️ 关键注意事项

焦点要求：QWidget 默认不接收键盘事件，务必调用 self.setFocusPolicy(Qt.FocusPolicy.StrongFocus) 并确保控件获得焦点（例如点击它或调用 self.setFocus()）；
事件接受机制：对已处理的组合事件建议调用 event.accept()，避免重复触发或干扰其他逻辑；未处理的事件应交由 super() 处理；
跨平台兼容性：该方案在 Windows/macOS/Linux 上均稳定有效，不依赖系统级钩子；
性能无负担：状态变量读写开销极小，适用于高频交互场景（如绘图工具、游戏控制）；
扩展性强：可轻松扩展支持 Ctrl/Shift/Alt 与其他键的嵌套组合（例如 self.lmb_pressed and event.modifiers() & Qt.KeyboardModifier.ControlModifier）。

通过这种“状态驱动 + 事件协同”的设计，你完全摆脱了 KeyboardModifier 枚举的限制，自由定义任意鼠标键 + 字母/数字键的组合行为，为复杂交互界面提供坚实基础。