Matplotlib嵌入Qt5滚动窗口后key_press_event事件无法触发

问题核心是QScrollArea会拦截键盘事件，导致内部的Matplotlib FigureCanvas无法接收到key_press_event——鼠标事件不受影响是因为QScrollArea不会拦截鼠标点击类事件。

解决方案1：让FigureCanvas获取焦点 #

修改ScrollableWindow类，在将canvas添加到scroll后，设置canvas的焦点策略并让它主动获取焦点，确保键盘事件能传递到Matplotlib画布：

class ScrollableWindow(QtWidgets.QMainWindow):
    def __init__(self, fig):
        self.qapp = QtWidgets.QApplication([])

        QtWidgets.QMainWindow.__init__(self)
        self.widget = QtWidgets.QWidget()
        self.setCentralWidget(self.widget)
        self.widget.setLayout(QtWidgets.QVBoxLayout())
        self.widget.layout().setContentsMargins(0,0,0,0)
        self.widget.layout().setSpacing(0)

        self.fig = fig
        self.canvas = FigureCanvas(self.fig)
        self.canvas.draw()
        self.scroll = QtWidgets.QScrollArea(self.widget)
        self.scroll.setWidget(self.canvas)

        # 添加以下两行，让canvas具备接收键盘事件的能力
        self.canvas.setFocusPolicy(QtCore.Qt.StrongFocus)
        self.canvas.setFocus()

        self.nav = NavigationToolbar(self.canvas, self.widget)
        self.widget.layout().addWidget(self.nav)
        self.widget.layout().addWidget(self.scroll)

        self.show()
        exit(self.qapp.exec_()) 

解决方案2：重写QScrollArea转发键盘事件 #

如果需要保留QScrollArea的原生键盘滚动功能（比如方向键滚动），同时让Matplotlib接收其他按键事件，可以自定义QScrollArea类，重写keyPressEvent实现事件转发：

class CustomScrollArea(QtWidgets.QScrollArea):
    def __init__(self, parent=None):
        super().__init__(parent)
    
    def keyPressEvent(self, event):
        # 优先让canvas处理事件，未被处理的事件再交给QScrollArea
        canvas = self.widget()
        if canvas and hasattr(canvas, 'keyPressEvent'):
            canvas.keyPressEvent(event)
            if not event.isAccepted():
                super().keyPressEvent(event)
        else:
            super().keyPressEvent(event)

然后在ScrollableWindow中替换原有ScrollArea：

self.scroll = CustomScrollArea(self.widget)
self.scroll.setWidget(self.canvas)

测试验证 #

使用你原有的测试代码验证效果：

def key_selector(event):
    print(f'Key pressed: {event.key}')

fig, axes = plt.subplots(ncols=4, nrows=5, figsize=(16,16))
for ax in axes.flatten():
    ax.plot([2,3,5,1])

fig.canvas.mpl_connect('key_press_event', key_selector)
a = ScrollableWindow(fig)

现在按下任意按键，控制台会输出对应的按键信息，说明key_press_event已正常触发。

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