如何在PyQt5中捕获鼠标4、5、6、7按键的触发事件

问题原因 #

Qt在X11平台默认会将X按钮4/5映射为滚轮事件，不会作为普通鼠标按键分发；按钮6/7不属于Qt默认处理的标准鼠标按键范围，因此不会触发mousePressEvent回调。数位板pan操作触发的X按钮事件被Qt拦截转换或者丢弃，因此无法通过标准事件回调捕获。

解决方案1：修改Qt全局属性（优先尝试） #

在初始化QApplication时添加两个属性配置，开启额外鼠标按键支持：

if __name__ == '__main__':
    app = QtWidgets.QApplication(sys.argv)
    from PyQt5.QtCore import Qt
    # 开启未处理数位板事件自动转为鼠标事件的逻辑
    app.setAttribute(Qt.AA_SynthesizeMouseForUnhandledTabletEvents, True)
    # 禁止Qt将X11原生的按钮4/5转换为滚轮事件
    app.setAttribute(Qt.AA_X11DoNotSendWheelEventsForMouseButtons4And5, True)
    window = MainWindow()
    window.show()
    app.exec_()

配置完成后重新测试，大多数情况下按钮4/5/6/7会触发mousePressEvent，对应的按钮枚举值分别为Qt.XButton1、Qt.XButton2、Qt.ExtraButton1、Qt.ExtraButton2。

解决方案2：直接解析原生事件（兼容性更强） #

如果方案1无效，可直接在已捕获的xcb原生事件中解析按钮事件，不依赖Qt的事件分发逻辑：

import sys
import struct
from PyQt5 import QtWidgets, QtGui, QtCore

# XCB事件类型常量
XCB_BUTTON_PRESS = 4
XCB_BUTTON_RELEASE = 5

class MainWindow(QtWidgets.QMainWindow):
    def __init__(self):
        super().__init__()
        self.setFixedWidth(500)
        self.setFixedHeight(500)

    def nativeEvent(self, eventType, message):
        if eventType == b'xcb_generic_event_t':
            msg_ptr = int(message)
            # 读取事件类型
            event_type = struct.unpack('B', struct.pack('P', msg_ptr))[0] & 0x7F
            if event_type in (XCB_BUTTON_PRESS, XCB_BUTTON_RELEASE):
                # 解析按钮编号
                button_code = struct.unpack('B', struct.pack('P', msg_ptr + 1))[0]
                if button_code in (4,5,6,7):
                    is_press = event_type == XCB_BUTTON_PRESS
                    print(f"捕获到按钮{button_code}{'按下' if is_press else '释放'}事件")
                    # 此处可添加自定义业务逻辑，也可手动构造QMouseEvent后分发给Qt事件循环
        return super().nativeEvent(eventType, message)

    # 其余事件回调方法保持原有实现即可

内容的提问来源于stack exchange，提问作者R. dV