Excel OfficeJS中单元格/行/列合并/取消合并触发事件咨询

Office JavaScript API没有专门针对单元格合并/取消合并的原生事件，你遇到的onChange返回RangeEdited是预期行为——合并操作会被归类为范围编辑事件。但可以通过以下方法识别这类操作：

基于onChange事件的二次校验 #

利用onChange触发后的回调，对比操作前后目标区域的合并状态差异：

1. 提前缓存当前工作表的所有合并区域信息（通过getUsedRange().getMergedAreas()获取）
2. 当onChange事件触发时，重新获取当前合并区域，与缓存数据对比，新增的区域对应合并操作，消失的区域对应取消合并操作。

代码示例（Office JS） #

// 缓存初始合并区域地址
let cachedMergedAddresses = [];

// 初始化缓存
async function initMergedCache() {
  await Excel.run(async (context) => {
    const activeSheet = context.workbook.activeWorksheet;
    const mergedAreas = activeSheet.getUsedRange().getMergedAreas();
    mergedAreas.load('address');
    await context.sync();
    cachedMergedAddresses = mergedAreas.items.map(area => area.address);
  });
}

// 监听文档变更事件
Office.context.document.addHandlerAsync(Office.EventType.DocumentSelectionChanged, async () => {
  await Excel.run(async (context) => {
    const activeSheet = context.workbook.activeWorksheet;
    const currentMergedAreas = activeSheet.getUsedRange().getMergedAreas();
    currentMergedAreas.load('address');
    await context.sync();
    const currentAddresses = currentMergedAreas.items.map(area => area.address);

    // 检测合并/取消合并操作
    const newMerges = currentAddresses.filter(addr => !cachedMergedAddresses.includes(addr));
    const removedMerges = cachedMergedAddresses.filter(addr => !currentAddresses.includes(addr));

    if (newMerges.length) console.log('合并操作：', newMerges);
    if (removedMerges.length) console.log('取消合并操作：', removedMerges);

    // 更新缓存
    cachedMergedAddresses = currentAddresses;
  });
});

// 初始化调用
initMergedCache();

VBA场景补充 #

如果使用VBA开发，可直接监听Worksheet_Change事件，通过Target.MergeCells属性判断目标区域的合并状态变化，或结合Worksheet_SelectionChange辅助校验。

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