使用 Excel JavaScript API 撤消支持

Excel 加载项支持撤消行为。 这将保留 Excel JavaScript API 执行的作和用户在 Excel 中执行的作。 这些作将保存在单个用户的 撤消堆栈 中，允许用户在需要时回退其作。

撤消分组

Excel JavaScript API 还支持撤消分组。 这样，就可以将多个 API 调用分组到外接程序用户的单个可撤消作中。 例如，如果外接程序需要跨多个工作表进行多个不同的更新以响应单个用户命令，则可以将所有这些更新包装在一个组中。 这是通过 mergeUndoGroup 提供给 函数的 属性完成的 Excel.run 。

如果组中的 API 不提供撤消支持，则会 UndoNotSupported 引发错误，告知你无法对作进行分组。 加载项应正常处理此错误，并向用户显示一条合理的消息。

以下代码示例演示如何合并设置为 true的mergeUndoGroup多个作。

await Excel.run({ mergeUndoGroup: true }, async (context) => { 
    const sheet = context.workbook.worksheets.getActiveWorksheet(); 
    let range = sheet.getRange("A1"); 
    range.values = [["123"]]; 
    
    await context.sync(); 
    
    range = sheet.getRange("B2"); 
    range.values = [["456"]];

    await context.sync(); 
}); 

不支持的 API

大多数 Excel JavaScript API 都支持撤消作。 但是，请参阅下表，了解不支持撤消行为的 API 列表。

另请参阅

• Excel 加载项中的 Word JavaScript 对象模型