使用cfspreadsheet如何删除或更新Excel单元格批注？

问题根源 #

CF自带的SpreadsheetSetCellComment函数没有内置覆盖已有批注的逻辑，直接重复调用会触发POI底层的java.lang.IllegalArgumentException: Multiple cell comments in one cell are not allowed错误；而手动添加锚点标签的操作会破坏Excel的XML结构，导致文件损坏，Office打开时自动移除批注数据。

解决方案：直接操作POI底层API #

由于CF的Spreadsheet对象底层基于Apache POI实现，我们可以直接调用POI的API来处理批注，避免CF函数的限制。

1. 更新单元格批注

先删除目标单元格的现有批注，再添加新批注：

// 加载目标Excel文件
spreadsheetObj = SpreadsheetRead("C:/path/to/your/file.xlsx");
// 获取POI工作簿对象
workbook = spreadsheetObj.getWorkbook();
// 获取目标工作表（索引从0开始）
targetSheet = workbook.getSheetAt(0);
// 获取目标单元格（POI行/列索引从0开始，对应CF的行1/列1即A1）
targetCell = targetSheet.getRow(0).getCell(0);

// 检查并删除现有批注
if (IsDefined("targetCell") && targetCell.getCellComment() neq null) {
    targetCell.removeCellComment();
}

// 添加新批注（CF的行/列索引从1开始）
SpreadsheetSetCellComment(spreadsheetObj, "更新后的批注内容", 1, 1);

// 保存修改后的文件
SpreadsheetWrite(spreadsheetObj, "C:/path/to/updated/file.xlsx", true);

2. 删除单元格批注

仅删除批注，保留单元格内容：

spreadsheetObj = SpreadsheetRead("C:/path/to/your/file.xlsx");
workbook = spreadsheetObj.getWorkbook();
targetSheet = workbook.getSheetAt(0);
targetCell = targetSheet.getRow(0).getCell(0);

if (IsDefined("targetCell") && targetCell.getCellComment() neq null) {
    targetCell.removeCellComment();
}

SpreadsheetWrite(spreadsheetObj, "C:/path/to/updated/file.xlsx", true);

3. 清除单元格（含数据和批注）

同时清除单元格内容和批注：

spreadsheetObj = SpreadsheetRead("C:/path/to/your/file.xlsx");
workbook = spreadsheetObj.getWorkbook();
targetSheet = workbook.getSheetAt(0);
targetRow = targetSheet.getRow(0);
targetCell = targetRow.getCell(0);

// 删除批注
if (IsDefined("targetCell") && targetCell.getCellComment() neq null) {
    targetCell.removeCellComment();
}

// 清除单元格内容（设为空白）
if (IsDefined("targetCell")) {
    targetCell.setBlank();
} else {
    // 若单元格不存在，创建空白单元格
    targetCell = targetRow.createCell(0);
    targetCell.setBlank();
}

SpreadsheetWrite(spreadsheetObj, "C:/path/to/updated/file.xlsx", true);

关键注意事项 #

• CF的行/列索引从1开始，而POI的行/列索引从0开始，使用时注意转换。
• 代码兼容.xls（HSSF）和.xlsx（XSSF）两种格式。
• 保存文件时，SpreadsheetWrite的第三个参数设为true表示覆盖现有文件。

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