QGIS插件开发：Python复制布局元素并导出PDF不丢失地图焦点

问题分析 #

第一段代码问题 #

代码中item_new未定义，推测你想直接将原布局的元素添加到新布局，但单个布局元素只能属于一个布局实例，直接调用addItem(item)会将元素从原布局转移到新布局，且未完整复制元素的所有属性（比如地图的渲染上下文、页面绑定关系），导致导出PDF时丢失地图焦点。

第二段代码问题 #

你创建了新的QgsLayoutItemMap并设置了基础属性，但缺少关键步骤：未将地图元素绑定到目标布局的页面，也未刷新渲染状态，导致元素仅在对象列表可见，实际渲染时处于“页面外”，无法在PDF中显示。

解决方案 #

方案一：批量复制布局元素（通用方法） #

使用QGIS内置的XML复制方法，完整保留元素的所有属性：

from qgis.core import QgsReadWriteContext, QgsLayoutItemUtils

# 获取原布局与目标布局
layout_model = project.layoutManager().layoutByName("LayoutNameModel")
composition = project.layoutManager().layoutByName(layoutName)

if layout_model and composition:
    # 筛选需要复制的元素类型
    target_item_types = (QgsLayoutItemPolyline, QgsLayoutItemPicture, QgsLayoutItemMap, QgsLayoutItemLegend)
    target_items = [item for item in layout_model.items() if isinstance(item, target_item_types)]
    
    for item in target_items:
        # 将原元素转为XML格式
        item_xml = item.writeXml(QgsReadWriteContext())
        # 从XML创建新元素并关联到目标布局
        new_item = QgsLayoutItemUtils.createItemFromXml(item_xml, composition, QgsReadWriteContext())
        if new_item:
            # 复制原元素的位置与尺寸
            new_item.setRect(item.rect())
            # 添加到目标布局
            composition.addItem(new_item)
    # 刷新布局确保渲染生效
    composition.refresh()

方案二：单独复制地图元素（修复你的代码） #

针对地图元素，补充页面绑定与完整配置复制：

layout_name1 = 'Name_First_Layout'
layout1 = project.layoutManager().layoutByName(layout_name1)

layout_name2 = 'Name_Second_Layout'
layout2 = project.layoutManager().layoutByName(layout_name2)

item_name = 'Map 1'
item1 = layout1.itemById(item_name)

if item1 and isinstance(item1, QgsLayoutItemMap) and layout2:
    # 创建新地图元素并关联目标布局
    item2 = QgsLayoutItemMap(layout2)
    # 复制原元素的位置与尺寸
    item2.setRect(item1.rect())
    # 绑定到目标布局的第一个页面（关键步骤）
    item2.setPage(layout2.pageCollection().pages()[0])
    # 复制地图核心配置
    item2.setLayers(item1.layers())
    item2.setExtent(item1.extent())
    item2.setScale(item1.scale())
    # 完整复制地图渲染设置（含背景、标注等）
    item2.setMapSettings(item1.mapSettings())
    # 添加到布局并刷新
    layout2.addLayoutItem(item2)
    item2.refresh()
    layout2.refresh()

核心注意事项 #

• 禁止直接将一个布局的元素添加到另一个布局，必须创建副本，每个布局元素仅能归属一个布局实例。
• 复制元素时必须调用setPage()绑定到目标布局的页面，否则元素会处于页面外，无法被渲染。
• 复制地图元素时使用setMapSettings()能完整继承原地图的所有渲染配置，避免焦点丢失或渲染异常。

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