本文介绍在 pyqt6中检测鼠标按键（如左键）与普通键盘字母或数字键（如“1”）同时按下的方法，解决qmouseevent对象无key()方法的问题，通过状态标记+事件协同实现自定义组合键逻辑。
本文介绍在 pyqt6中检测鼠标按键（如左键）与普通键盘字母或数字键（如“1”）同时按下的方法，解决qmouseevent对象无key()方法的问题，通过状态标记+事件协同实现自定义组合键逻辑。
在 PyQt6 中，QMouseEvent（如 mousePressEvent 的参数）不包含键盘状态信息，因此直接调用 event.key() 会引发 AttributeError。这是因为鼠标事件和键盘事件由不同机制触发，Qt 并不自动将键盘修饰状态（如 Ctrl/Shift）以外的按键状态注入鼠标事件中。若需实现类似「左键 + 按下数字键 1」的组合操作（即非标准修饰键的自定义组合），必须手动维护鼠标按键的实时按下状态，并在键盘事件中结合该状态进行判断。
核心思路是：用类属性记录鼠标按钮的当前按下状态（lmb_pressed, rmb_pressed 等），在 mousePressEvent 中设为 True，在 mouseReleaseEvent 中及时设为 False；随后在 keyPressEvent 中检查该状态与 event.key() 的组合条件。
以下为完整可运行示例（适配 PyQt6，已替换 PySide6 相关导入）：
import sys
from PyQt6.QtWidgets import QWidget, QApplication, QLabel, QVBoxLayout
from PyQt6.QtCore import Qt
from PyQt6.QtGui import QMouseEvent
class MyWidget(QWidget):
def __init__(self):
super().__init__()
self.setWindowTitle("Mouse + Key Combo Demo")
self.resize(400, 200)
# 状态标记：跟踪鼠标按键是否处于按下状态
self.lmb_pressed = False
self.rmb_pressed = False
# 简单 UI 提示
layout = QVBoxLayout()
self.label = QLabel("点击窗口区域，尝试：\n• 左键 + 1 → 触发组合动作\n• 单独按 1 → 基础动作")
layout.addWidget(self.label)
self.setLayout(layout)
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):
# 组合判定：仅当左键已按下时，才响应数字键 1
if self.lmb_pressed and event.key() == Qt.Key.Key_1:
self.label.setText("✅ 左键 + '1' 已触发！")
print("Left mouse button + '1' pressed simultaneously")
event.accept() # 显式接受事件，避免被父类处理
return
# 基础按键行为（未配合鼠标时）
if event.key() == Qt.Key.Key_1:
self.label.setText("? 单独按下 '1'")
print("Standalone '1' key pressed")
event.accept()
return
# 其他键（如 Esc）可用来重置提示
if event.key() == Qt.Key.Key_Escape:
self.label.setText("点击区域，尝试组合键...")
event.accept()
return
super().keyPressEvent(event)
if __name__ == "__main__":
app = QApplication(sys.argv)
widget = MyWidget()
widget.show()
sys.exit(app.exec())
⚠️ 关键注意事项：
- 必须重写 mouseReleaseEvent：否则状态标记无法重置，导致后续按键持续误判（例如松开左键后仍认为 lmb_pressed=True）。
- 优先调用 event.accept()：在成功处理组合逻辑后显式调用，防止事件继续向上传播，干扰其他逻辑。
- 区分 Qt.Key.Key_1 与 Qt.Key_1：PyQt6 中键枚举位于 Qt.Key.* 命名空间（如 Qt.Key.Key_1），旧写法 Qt.Key_1 已弃用，需注意版本兼容性。
- 焦点问题：确保 Widget 可接收键盘事件——默认 QWidget 需设置 self.setFocusPolicy(Qt.FocusPolicy.StrongFocus) 并获取焦点（例如点击窗口后自动获得），或在构造函数末尾添加 self.setFocus()。
该方案灵活可扩展：只需新增布尔属性（如 self.shift_pressed）并在 keyPressEvent / keyReleaseEvent 中同步更新，即可支持更复杂的多键组合（如「左键 + Shift + A」）。它绕过了 KeyboardModifier 的限制，真正实现了任意鼠标键与任意字符键的协同判定，是构建高级交互控件（如绘图工具、快捷编辑面板）的基础实践。
