本文介绍在 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 枚举的限制，自由定义任意鼠标键 + 字母/数字键的组合行为，为复杂交互界面提供坚实基础。
