【xlwings api语言参考】Range.Insert 方法

功能：
在工作表或宏表中插入一个单元格或单元格区域，其他单元格相应移位以腾出空间。

语法：
rng.Insert(Shift,CopyOrigin)
rng是一个表示 Range 对象的变量。

参数：
名称 必需/可选 数据类型 说明
Shift 可选 Variant 指定单元格的调整方式。 可以是以下 XlInsertShiftDirection 常量之一： xlShiftToRight 或 xlShiftDown。 如果省略此参数，Microsoft Excel 将根据区域的形状确定调整方式。
CopyOrigin 可选 Variant 复制源;即，从何处复制插入单元格的格式。 可以是以下 XlInsertFormatOrigin 常量之一： xlFormatFromLeftOrAbove (默认值) xlFormatFromRightOrBelow。

注解：
CopyOrigin 没有等效于在文档中以交互方式插入单元格时清除格式Excel。 为此，请使用 ClearFormats 方法。

rng=sht.api.Range('B2:E5')
rng.Insert(xw.constants.InsertShiftDirection.xlShiftDown)
rng.ClearFormats()

示例：
本示例在第 2 行上方插入一行，复制第 3 行 (行) 而不是标题行中的格式。

sht.api.Range('2:2').Insert(CopyOrigin=xw.constants.InsertFormatOrigin.xlFormatFromRightOrBelow)

点这里看视频课程