xlwings如何选中含图表、形状等所有元素的整个工作表

问题背景 #

需求是将源工作簿指定工作表的全部内容（包括单元格内容、格式、图表、图片、形状等所有元素），复制粘贴到目标工作表的A4单元格位置。
原有两类实现方案都存在明显缺陷：

• 硬编码大范围（如A1:Z10000）：如果内容超出预设范围会遗漏，存在不稳定风险
• used_range方案：仅能识别有编辑记录的单元格区域，会忽略锚点在区域外的图表、图片、形状等非单元格对象

最优实现方案 #

直接调用Excel底层API的全选逻辑，效果和手动点击工作表左上角的全选三角按钮、按Ctrl+A全选完全一致，会覆盖工作表所有单元格，同时携带所有锚定在工作表上的对象，不存在遗漏问题。
完整实现代码：

import xlwings as xw

# 配置文件路径
source_path = r'C:\Users\Desktop\test.xlsx'
save_path = r'C:\Users\Desktop\output.xlsx'

# 启动Excel进程
app = xw.App(visible=False, add_book=False)
try:
    # 打开源工作簿、新建目标工作簿
    wb_source = app.books.open(source_path)
    wb_target = app.books.add()
    ws_source = wb_source.sheets[0]
    ws_target = wb_target.sheets[0]

    # 全选源工作表所有内容并复制
    ws_source.api.Cells.Copy()
    # 粘贴到目标表A4起始位置
    ws_target.range('A4').api.PasteSpecial()

    # 退出复制模式，清空剪贴板状态
    app.api.CutCopyMode = False
    # 保存结果文件
    wb_target.save(save_path)
finally:
    # 回收资源，避免后台残留Excel进程
    wb_source.close()
    wb_target.close()
    app.quit()

方案说明 #

• 该方法选中的是工作表全部1048576行、16384列单元格，无论内容、对象放在工作表什么位置都能被完整复制，不需要手动估算范围边界
• 注意xlwings Python API的工作表索引从0开始，sheets[0]对应工作簿的第一个工作表，和VBA中1基的Sheets(1)是同一个对象
• 支持自定义粘贴类型，如果不需要粘贴全部内容，可以给PasteSpecial传入对应参数调整，比如只粘贴值和数字格式时，将粘贴行替换为ws_target.range('A4').api.PasteSpecial(Paste=-4163)即可
• 相比used_range方案，不会漏掉浮动在空白单元格区域的图表、图片、控件、形状等非单元格元素，完全匹配手动全选复制的效果

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