Matplotlib导航工具栏平移/缩放按钮激活时无背景高亮问题

问题分析 #

Pan/Zoom按钮属于带checkable属性的QAction，激活时会触发checked=True状态，但默认Qt工具栏按钮的选中样式未生效，尤其是自定义图标后，需要手动配置样式或确保状态同步。

修复步骤 #

1. 修正MatplotlibWidget初始化顺序（必做） #

原代码中先创建toolbar再初始化canvas会导致错误，调整初始化顺序：

class MatplotlibWidget(QWidget):
    def __init__(self, parent=None):
        super(MatplotlibWidget, self).__init__(parent)        
        # 先创建figure和canvas
        self.figure, self.subplot_dict = plt.subplots()
        self.canvas = Canvas(self.figure)
        # 再初始化toolbar
        self.toolbar = CustomNavigationToolbar(self.canvas, self)
        # 初始化布局并添加canvas
        self.layout = QVBoxLayout(self)
        self.layout.addWidget(self.canvas)

2. 方法一：通过Qt样式表设置选中高亮 #

在MainWindow中给toolbar添加样式表，定义选中状态的背景效果：

class MainWindow(QMainWindow):
    def __init__(self):
        QMainWindow.__init__(self)
        # ... 其他初始化代码 ...
        self.ui.tb_frame.layout().addWidget(self.mpl_widget.toolbar)
        # 配置选中状态样式
        self.mpl_widget.toolbar.setStyleSheet("""
        QToolButton:checked {
            background-color: #a0c4ff; /* 自定义高亮颜色 */
            border-radius: 3px;
        }
        QToolButton:hover {
            background-color: #e0efff; /* 可选：鼠标悬停样式优化 */
        }
        """)
        # ... 自定义图标代码 ...

3. 方法二：自定义Toolbar确保状态同步（可选） #

如果样式表生效但状态仍异常，重写Toolbar类强制同步按钮选中状态：

from matplotlib.backends.backend_qt5agg import NavigationToolbar2QT as NavigationToolbar

class CustomNavigationToolbar(NavigationToolbar):
    def pan(self, *args):
        super().pan(*args)
        # 同步Pan按钮选中状态
        pan_action = self._actions.get('pan')
        if pan_action:
            pan_action.setChecked(self._active == 'PAN')
    
    def zoom(self, *args):
        super().zoom(*args)
        # 同步Zoom按钮选中状态
        zoom_action = self._actions.get('zoom')
        if zoom_action:
            zoom_action.setChecked(self._active == 'ZOOM')

随后在MatplotlibWidget中替换为自定义Toolbar：

self.toolbar = CustomNavigationToolbar(self.canvas, self)

版本适配 #

该方案适配以下版本：

• Python v3.11
• Matplotlib v3.7.4
• PySide6 v6.5.1
• Qt v6.5.1

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