嵌入PyQt的Vispy场景按键被拦截，如何指定按键交由PyQt监听？

我在PyQt应用中嵌入Vispy场景显示散点图，想要给整个应用添加类Vim的自定义命令模式按键事件。应用结构如下：

主窗口初始化：

app = QApplication(sys.argv)
win = QMainWindow()

Vispy场景嵌入代码：

canv_lay = QGridLayout()
canv_frame = QFrame()
canv_frame.setFrameStyle(1)
canv_frame.setLayout(canv_lay)
canv_lay.addWidget(vp.canvas.native)

主窗口布局组合：

mid_lay = QHBoxLayout()
mid_lay.addWidget(sidebar_frame)
mid_lay.addWidget(canv_frame)
main = QWidget()
main_lay = QGridLayout()
main_lay.addLayout(mid_lay,0,0,8,1)
main_lay.addLayout(cns_lay,10,0,1,1)
main.setLayout(main_lay)
win.setCentralWidget(main)

我给主窗口绑定了按键监听函数ex_command：

win.keyPressEvent = ex_command

原本监听正常，但点击Vispy绘图区域后，按键监听就失效了，只有点击其他框架才会恢复。推测是Vispy捕获了移动/缩放相关的按键事件，尝试给canvas_frame、canvas_layout添加监听也无效。请问能否让特定按键不被Vispy捕获，转而由我的监听函数处理？

方法1：给Vispy画布安装事件过滤器拦截特定按键 #

Vispy画布会优先抢占按键事件，通过事件过滤器可以拦截指定按键，直接转发给主窗口的监听函数，不让Vispy处理。

示例代码：

from PyQt5.QtCore import QObject, QEvent, Qt

class KeyFilter(QObject):
    def eventFilter(self, obj, event):
        if event.type() == QEvent.KeyPress:
            # 定义需要自定义处理的按键集合
            target_keys = [Qt.Key_H, Qt.Key_J, Qt.Key_K, Qt.Key_L, Qt.Key_Escape]
            if event.key() in target_keys:
                # 转发事件给主窗口的keyPressEvent
                win.keyPressEvent(event)
                return True  # 返回True表示事件已处理，Vispy不再接收
        # 非目标按键交给Vispy默认处理
        return super().eventFilter(obj, event)

# 给Vispy画布安装过滤器
key_filter = KeyFilter()
vp.canvas.native.installEventFilter(key_filter)

方法2：禁用Vispy默认的交互控件 #

如果不需要Vispy自带的缩放、平移等按键交互，可以直接关闭对应的交互逻辑，让Vispy不再捕获任何按键事件。

示例代码：

# 禁用ViewBox的默认交互（适用于SceneCanvas场景）
vp.viewbox.interactive = False

# 或者直接移除Camera的键盘处理器
vp.viewbox.camera._keyboard_handler = None

注意：此方法会完全关闭Vispy的默认按键交互，仅适合不需要Vispy自带按键操作的场景。

方法3：重写Vispy画布的按键事件方法 #

直接替换Vispy画布的keyPressEvent，先处理自定义按键，再将其余事件交给Vispy原始逻辑处理。

示例代码：

# 保存Vispy原始的按键事件方法
original_key_event = vp.canvas.native.keyPressEvent

def custom_key_press(event):
    target_keys = [Qt.Key_H, Qt.Key_J, Qt.Key_K, Qt.Key_L, Qt.Key_Escape]
    if event.key() in target_keys:
        # 自定义按键交给主窗口处理
        win.keyPressEvent(event)
    else:
        # 其他按键交给Vispy默认处理
        original_key_event(event)

# 替换Vispy画布的按键事件方法
vp.canvas.native.keyPressEvent = custom_key_press

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