通过

使用 Excel JavaScript API 插入单元格区域

  • 项目

本文提供了一个代码示例，该示例使用 Excel JavaScript API 插入单元格区域。 有关对象支持的属性和方法 Range 的完整列表，请参阅 Excel.Range 类。

注意

The Excel JavaScript API 没有“Cell”对象或类。 相反，Excel JavaScript API 将所有 Excel 单元格定义为 Range 对象。 Excel UI 中的单个单元格转换为 Excel JavaScript API 中包含一个单元格的 Range 对象。 单个 Range 对象也可以包含多个连续的单元格。 若要了解详细信息，请参阅使用 Excel JavaScript API 处理单元格。

插入多个单元格

下面的代码示例将多个单元格插入位置 B4:E4，并将其他单元格下移，以便为新的单元格提供空间。

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getItem("Sample");
    let range = sheet.getRange("B4:E4");

    range.insert(Excel.InsertShiftDirection.down);

    await context.sync();
});

插入区域之前的数据

插入区域之前 Excel 中的数据。

插入区域之后的数据

插入区域后 Excel 中的数据。

另请参阅