Matplotlib嵌入wxPython：macOS上导航工具栏TextCtrl无法正常工作

解决macOS下子类化WXAgg工具栏中TextCtrl不更新的问题 #

我之前在macOS上做类似的Matplotlib+wxPython嵌入式图表时，也碰到过同款TextCtrl不更新的坑！结合你的技术栈（Matplotlib 2.2.2、wxPython Phoenix 4.0.1、Python3.6.4），核心原因是macOS对UI线程的严格限制——Matplotlib的鼠标事件回调可能在非UI线程触发，直接修改wx控件会被系统拦截，导致控件毫无反应。下面是我验证有效的解决方案：

1. 用wx.CallAfter强制在UI线程更新TextCtrl

macOS的Cocoa框架要求所有UI操作必须在主线程执行，而Matplotlib的motion_notify_event回调不一定在主线程触发。所以必须用wx.CallAfter把TextCtrl的更新操作“投递”到wx的主事件循环中：

from matplotlib.backends.backend_wxagg import NavigationToolbar2WxAgg
import wx

class CustomToolbar(NavigationToolbar2WxAgg):
    def __init__(self, canvas):
        super().__init__(canvas)
        # 移除"configure subplots"工具
        self.DeleteTool(self._actions['configure_subplots'].id)
        
        # 创建只读TextCtrl并添加到工具栏
        self.coord_text = wx.TextCtrl(
            self, 
            style=wx.TE_READONLY | wx.TE_RIGHT | wx.BORDER_NONE
        )
        # 用wx工具栏的AddControl方法添加，避免布局冲突
        self.AddControl(self.coord_text)
        
        # 绑定鼠标移动事件
        self.canvas.mpl_connect('motion_notify_event', self.on_mouse_move)
    
    def on_mouse_move(self, event):
        if event.inaxes:
            # 格式化坐标文本
            coord_str = f"X: {event.xdata:.2f} | Y: {event.ydata:.2f}"
            # 用CallAfter确保在UI线程更新控件
            wx.CallAfter(self.coord_text.SetValue, coord_str)
        else:
            # 鼠标移出图表区域时清空文本
            wx.CallAfter(self.coord_text.SetValue, "")

2. 额外的macOS适配小细节

• 避免手动布局控件：一定要用工具栏的AddControl方法添加TextCtrl，不要自己用Sizer手动排版——macOS的wxPhoenix对原生工具栏的布局兼容性很差，手动布局容易导致控件被隐藏或无法响应更新。
• 确保事件传递正常：如果还是没反应，可以在初始化canvas后调用canvas.SetFocus()，避免父控件拦截Matplotlib的鼠标事件。

为什么之前的代码在其他系统正常？

Windows和Linux的UI线程限制没那么严格，直接在Matplotlib回调里修改wx控件不会被拦截，但macOS的Cocoa框架会直接忽略跨线程的UI操作，这就是你只在macOS上碰到问题的核心原因。

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