QGIS3.20前版本如何安全清除QgsMapToolExtent创建的范围元素？

针对不同QGIS版本，提供两种可靠的清除方案：

QGIS 3.20及以上版本 #

该版本的QgsMapToolExtent内置了clearRubberBand()方法，可直接清除工具创建的范围元素，无需额外处理：

# 直接调用内置方法清除范围
extent_tool.clearRubberBand()

QGIS 3.20以下版本 #

旧版本中工具创建的范围元素是QGraphicsRectItem（而非QgsRubberBand），且无法通过常规属性识别，推荐通过子类化工具跟踪元素的方式实现安全清除：

步骤1：子类化QgsMapToolExtent #

自定义工具类，重写事件方法以记录工具创建的矩形元素：

from qgis.gui import QgsMapToolExtent

class TrackableExtentTool(QgsMapToolExtent):
    def __init__(self, canvas):
        super().__init__(canvas)
        self._rect_item = None  # 存储工具创建的范围元素引用

    def canvasReleaseEvent(self, event):
        super().canvasReleaseEvent(event)
        # 捕获工具创建的私有矩形元素
        self._rect_item = self.mRectItem

    def clear_extent_rect(self):
        """清除画布上的范围元素"""
        if self._rect_item and self._rect_item.scene():
            self._rect_item.scene().removeItem(self._rect_item)
            self._rect_item = None

步骤2：使用自定义工具并清除元素 #

实例化自定义工具，需要清除范围时直接调用自定义方法：

# 获取地图画布
canvas = iface.mapCanvas()
# 实例化自定义范围工具
extent_tool = TrackableExtentTool(canvas)
# 设置为当前地图工具
canvas.setMapTool(extent_tool)

# 在需要清除范围的时机调用
extent_tool.clear_extent_rect()

替代方案（直接访问私有成员） #

如果不想子类化，可直接访问工具的私有成员mRectItem清除元素（注意：该方法依赖QGIS旧版本的内部实现，存在版本兼容性风险）：

# 检查私有成员是否存在并清除
if hasattr(extent_tool, 'mRectItem') and extent_tool.mRectItem:
    extent_tool.mRectItem.scene().removeItem(extent_tool.mRectItem)
    extent_tool.mRectItem = None

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