如何在指定NamedRange（NamedItem）中提取合并单元格的起始单元格

我需要创建一个对象来存储单元格地址、行索引和列索引，目前已实现基础功能，但遇到合并单元格的问题：比如A1和B1合并时，现有代码会同时获取A1和B1，我希望只保留A1（合并区域的起始单元格）。请问如何从指定的NamedRange中识别并提取这类合并区域的起始单元格？

根据示例表格，我期望从指定范围中仅获取A1和G1单元格，其余均为合并单元格。

参数说明 #

• sheetName：活动工作表名称
• Context：当前Office上下文
• SheetRange：单元格地址（如A1:I14）
• createRangeName：NamedItem的唯一名称（示例：S_361a26feb074409584f04deef2a9e354）

现有代码 #

async function setDefineNameInExcel(context, sheetName, SheetRange, createRangeName) {
    var uniqueNamedRange = createRangeName;
    let sheet = context.workbook.worksheets.getItem(sheetName);
    let range = sheet.getRange(SheetRange);
    sheet.names.add(uniqueNamedRange, range);
    range.load("address,rowCount,columnCount,cellCount,values");
    sheet.load("names");
    await context.sync();
    const propertiesToGet = range.getCellProperties({ address: true });
    await context.sync();
    for (let iRow = 0; iRow < range.rowCount; iRow++) {
        for (let iCol = 0; iCol < range.columnCount; iCol++) {
            const cellAddress = propertiesToGet.value[iRow][iCol];
            var address = cellAddress.address.slice(cellAddress.address.lastIndexOf("!") + 1)
            excelTableObj = {};
            excelTableObj.Range = uniqueNamedRange;
            excelTableObj.Address = address;
            excelTableObj.RowIndex = iRow;
            excelTableObj.ColIndex = iCol;
            lstexcelTableObj.push(excelTableObj);
        }
    }
}

解决方案 #

要识别合并区域的起始单元格，可通过Excel JavaScript API的getCellProperties方法获取单元格的mergeCell属性，其中isStart字段会标记该单元格是否为合并区域的左上角起始单元格。修改后的代码如下：

async function setDefineNameInExcel(context, sheetName, SheetRange, createRangeName) {
    var uniqueNamedRange = createRangeName;
    let sheet = context.workbook.worksheets.getItem(sheetName);
    let range = sheet.getRange(SheetRange);
    sheet.names.add(uniqueNamedRange, range);
    range.load("address,rowCount,columnCount,cellCount,values");
    sheet.load("names");
    await context.sync();
    // 获取单元格地址和合并单元格属性
    const propertiesToGet = range.getCellProperties({ 
        address: true,
        mergeCell: true 
    });
    await context.sync();
    for (let iRow = 0; iRow < range.rowCount; iRow++) {
        for (let iCol = 0; iCol < range.columnCount; iCol++) {
            const cellProps = propertiesToGet.value[iRow][iCol];
            // 仅保留合并区域的起始单元格，或非合并单元格
            if (cellProps.mergeCell.isStart) {
                var address = cellProps.address.slice(cellProps.address.lastIndexOf("!") + 1);
                const excelTableObj = {
                    Range: uniqueNamedRange,
                    Address: address,
                    RowIndex: iRow,
                    ColIndex: iCol
                };
                lstexcelTableObj.push(excelTableObj);
            }
        }
    }
}

关键说明 #

• 在getCellProperties中添加mergeCell: true，以获取单元格的合并属性信息。
• 通过判断cellProps.mergeCell.isStart是否为true，筛选出合并区域的起始单元格（左上角），非合并单元格的isStart同样为true，因此也会被保留，符合需求。

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