如何控制Matplotlib中多边形的zorder层级？

问题原因分析 #

• 坐标转换错误：你用event.x/event.y（屏幕像素坐标）调用contains_point，但该方法需要的是数据坐标，导致判断多边形是否被点击的逻辑失效，zorder设置根本没触发
• 刷新方式不正确：仅调用ax.draw_artist(self.poly)只会重绘单个多边形，但Matplotlib仍会按原层级顺序绘制所有元素，无法体现zorder变化
• 初始化时zorder未生效可能是因为未完全刷新画布，或未确认zorder是否被正确设置

zorder工作原理 #

Matplotlib中同一容器（如axes.patches）内的元素，绘制优先级由以下规则决定：

• zorder值越大，绘制时间越晚，显示在越上层
• 若zorder相同，按元素添加顺序绘制，后添加的元素在上方
• 不同类型元素（如patch、line）有默认zorder（patch默认1，line默认2），但同类型元素仅需比较自身zorder

解决方案 #

1. 修正按键事件处理逻辑 #

修复坐标转换问题，并正确刷新画布，同时动态设置最高zorder：

def on_key_press(self, event):
    if event.key == 't':
        # 将屏幕坐标转换为数据坐标
        data_point = self.ax.transData.inverted().transform((event.x, event.y))
        if self.poly.contains_point(data_point):
            # 获取当前所有多边形的最大zorder，设置为比最大值大1，确保置顶
            max_zorder = max(p.get_zorder() for p in self.ax.patches)
            self.poly.set_zorder(max_zorder + 1)
        else:
            # 恢复默认zorder（可根据需求调整）
            self.poly.set_zorder(1)
        # 刷新整个画布，使层级变化生效
        self.canvas.draw_idle()

2. 另一种更直观的方法：移动多边形到patches列表末尾 #

因为Matplotlib默认按axes.patches列表顺序绘制，最后一个元素会显示在最上层，无需手动设置zorder：

def on_key_press(self, event):
    if event.key == 't':
        data_point = self.ax.transData.inverted().transform((event.x, event.y))
        if self.poly.contains_point(data_point):
            # 从列表移除当前多边形，再添加到末尾，实现置顶
            if self.poly in self.ax.patches:
                self.ax.patches.remove(self.poly)
                self.ax.patches.append(self.poly)
        # 刷新画布
        self.canvas.draw_idle()

3. 初始化时设置zorder的正确方式 #

确保设置zorder后刷新画布，可验证zorder是否生效：

poly_editors = []
for i, poly in enumerate(polygons):
    ax.add_patch(poly)
    # 设置zorder，第一个多边形zorder最高，最后一个最低
    poly.set_zorder(len(polygons) - i)
    poly_editors.append(poly_editor.PolygonInteractor(ax, poly, canvas))
# 初始化后刷新画布
canvas.draw_idle()

验证方法 #

可以在代码中添加打印语句，确认zorder是否被正确设置：

print(poly.get_zorder()) # 检查zorder值

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