使用 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 处理单元格。

清除多个单元格内容

下面的代码示例清除区域 E2:E5 中的所有内容和单元格格式设置。

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

    range.clear();

    await context.sync();
});

清除区域之前的数据

清除区域之前 Excel 中的数据。

清除区域之后的数据

清除区域后 Excel 中的数据。

删除多个单元格

下面的代码示例删除 B4：E4 区域中的单元格，并将其他单元格向上移动以填充已删除单元格所空出的空间。

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

    range.delete(Excel.DeleteShiftDirection.up);

    await context.sync();
});

删除区域之前的数据

删除区域之前 Excel 中的数据。

删除区域之后的数据

删除区域后 Excel 中的数据。

另请参阅