如何用Office Scripts复制指定字符串间的单元格区域？

核心思路 #

先定位起始和结束文本对应的单元格，再根据这两个单元格的位置确定完整的目标区域，最后完成复制粘贴操作。

完整代码示例 #

function main(workbook: ExcelScript.Workbook) {
  // 获取源工作表与已使用范围
  const sourceSheet = workbook.getActiveWorksheet();
  const usedRange = sourceSheet.getUsedRange();
  if (!usedRange) {
    console.log("当前工作表无数据");
    return;
  }

  // 定义起始、结束文本
  const startText = "Name of Owner";
  const endText = "Total Amount Owed";

  // 查找起始单元格
  const startCell = usedRange.find(startText, {
    completeMatch: true,
    matchCase: false,
    searchDirection: ExcelScript.SearchDirection.forward
  });
  if (!startCell) {
    console.log(`未找到起始文本：${startText}`);
    return;
  }

  // 查找结束单元格
  const endCell = usedRange.find(endText, {
    completeMatch: true,
    matchCase: false,
    searchDirection: ExcelScript.SearchDirection.forward
  });
  if (!endCell) {
    console.log(`未找到结束文本：${endText}`);
    return;
  }

  // 定义完整目标区域（包含起始到结束的所有行，以及源数据的全部列）
  // 若仅需起始单元格所在列，将最后一个参数改为1即可
  const targetRange = sourceSheet.getRange(
    startCell.getRowIndex(),
    startCell.getColumnIndex(),
    endCell.getRowIndex() - startCell.getRowIndex() + 1,
    usedRange.getColumnCount()
  );

  // 获取第二个工作表（索引从0开始，第二个表的索引为1）
  const targetSheet = workbook.getWorksheets()[1];
  if (!targetSheet) {
    console.log("第二个工作表不存在");
    return;
  }

  // 复制区域并粘贴到目标工作表的A1起始位置
  // 若仅需粘贴值，将RangeCopyType.all改为RangeCopyType.values
  targetRange.copyTo(
    targetSheet.getRange("A1"),
    ExcelScript.RangeCopyType.all
  );
}

关键细节说明 #

• 区域定义逻辑：使用getRange(起始行索引, 起始列索引, 行数, 列数)构建范围，行数计算为结束行索引 - 起始行索引 + 1，确保包含起始和结束行。
• 灵活调整列范围：如果不需要复制整行，仅需起始到结束文本所在的列范围，可将列数参数改为endCell.getColumnIndex() - startCell.getColumnIndex() + 1。
• 异常处理：加入了无数据、未找到目标文本、目标工作表不存在的判断，避免脚本运行报错。

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