Office Scripts-Excel：如何格式化单元格字符串的部分内容？

问题说明 #

• 需求：Excel单元格包含字符串，需通过Office Scripts仅对字符串的部分内容设置格式（如加粗），例如将单元格内容“Cell content”中的“content”部分设为加粗。
• 错误代码问题：Copilot给出的代码无法运行，因为setBold方法仅接受一个参数，错误代码如下：

cellRange.getFormat().getFont().setBold(true, { start: 0, end: 3 })

正确实现方案 #

要对单元格内的部分文本设置格式，需使用Range.getCharacters(start, length)方法定位目标文本片段，再单独设置其字体格式。示例代码如下：

function main(workbook: ExcelScript.Workbook) {
  // 获取目标工作表和单元格（示例为Sheet1的A1单元格）
  const targetCell = workbook.getWorksheet("Sheet1").getRange("A1");
  // 获取单元格的文本内容
  const cellContent = targetCell.getValue() as string;

  // 定义需要加粗的文本范围：起始索引和长度
  // 示例中"Cell content"里的"content"从索引5开始，长度为7
  const startPos = 5;
  const textLength = 7;

  // 定位到目标文本片段并设置加粗
  targetCell.getCharacters(startPos, textLength).getFormat().getFont().setBold(true);
}

关键说明 #

• getCharacters(start, length)：该方法用于选中单元格内指定范围的文本，第一个参数是文本的起始索引（从0开始计数），第二个参数是目标文本的长度。
• 链式调用格式设置：通过getFormat().getFont().setBold(true)，仅对选中的文本片段应用加粗格式，不影响单元格内的其他文本。

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