Officeスクリプト clear() メソッドの使い方｜値のみクリアや書式リセットを自在に

function main(workbook: ExcelScript.Workbook) {
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  
  // セル範囲 "B2:D4" を指定
  let range: ExcelScript.Range = sheet.getRange("B2:D4");

  // セルのデータ、書式、ハイパーリンクをすべて削除
  range.clear();
}

function main(workbook: ExcelScript.Workbook) {
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  
  // セル範囲 "B2:D4" を指定
  let range: ExcelScript.Range = sheet.getRange("B2:D4");

  // セルのデータ、書式、ハイパーリンクをすべて削除
  range.clear(ExcelScript.ClearApplyTo.all);
}

function main(workbook: ExcelScript.Workbook) {
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  
  // セル範囲 "B2:D4" を指定
  let range: ExcelScript.Range = sheet.getRange("B2:D4");

  // セル内のデータのみ削除（書式とハイパーリンクは保持）
  range.clear(ExcelScript.ClearApplyTo.contents);
}

function main(workbook: ExcelScript.Workbook): void {
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  
  // セル範囲 "B2:D4" を指定
  let range: ExcelScript.Range = sheet.getRange("B2:D4");

  // セルの書式のみ削除（データとハイパーリンクは保持）
  range.clear(ExcelScript.ClearApplyTo.formats);
}

function main(workbook: ExcelScript.Workbook): void {
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  
  // セル範囲 "B2:D4" を指定
  let range: ExcelScript.Range = sheet.getRange("B2:D4");

  // セル内のハイパーリンクのみ削除（データと書式は保持）
  range.clear(ExcelScript.ClearApplyTo.hyperlinks);
}

function main(workbook: ExcelScript.Workbook) {
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  let range: ExcelScript.Range = sheet.getRange("B2:D4");

  // 指定範囲のすべてのデータ、書式、リンクをクリア
  range.clear(ExcelScript.ClearApplyTo.all);
}

function main(workbook: ExcelScript.Workbook): void {
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  let rowRange: ExcelScript.Range = sheet.getRange("2:2");

  // 2行目のすべての内容と書式をクリア
  rowRange.clear(ExcelScript.ClearApplyTo.all);
}

function main(workbook: ExcelScript.Workbook) {
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  let columnRange: ExcelScript.Range = sheet.getRange("B:B");

  // B列のすべての内容と書式をクリア
  columnRange.clear(ExcelScript.ClearApplyTo.all);
}

function main(workbook: ExcelScript.Workbook): void {
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  let usedRange: ExcelScript.Range = sheet.getUsedRange();

  // シート全体の内容と書式をクリア
  usedRange.clear(ExcelScript.ClearApplyTo.all);
}

function main(workbook: ExcelScript.Workbook): void {
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  let dynamicRange: ExcelScript.Range = sheet.getRange("B2").getResizedRange(1, 2);

  // B2から2行×3列の範囲をクリア
  dynamicRange.clear(ExcelScript.ClearApplyTo.all);
}

function main(workbook: ExcelScript.Workbook) {
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  
  // 使用中のセル範囲を取得して、すべてのデータと書式をクリア
  let usedRange: ExcelScript.Range = sheet.getUsedRange();
  usedRange.clear(ExcelScript.ClearApplyTo.all);
}

function main(workbook: ExcelScript.Workbook) {
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  let backupSheet: ExcelScript.Worksheet = workbook.addWorksheet("Backup");

  // 使用中の範囲を取得
  let usedRange: ExcelScript.Range = sheet.getUsedRange();

  // データをバックアップシートにコピー
  backupSheet.getRange("A1").copyFrom(usedRange);

  // 元のシートでデータと書式をクリア
  usedRange.clear(ExcelScript.ClearApplyTo.all);
}

function main(workbook: ExcelScript.Workbook): void {
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  let range: ExcelScript.Range = sheet.getRange("B2:D4");

  // セル範囲の内容をすべてクリア
  range.clear(ExcelScript.ClearApplyTo.all);

  // クリア後に列幅を標準幅に戻す
  range.getColumn(0).getFormat().setColumnWidth(8.43); // Excelの標準幅
}

function main(workbook: ExcelScript.Workbook) {
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();
  let rowToDelete: ExcelScript.Range = sheet.getRange("3:3");

  // 3行目を削除して、下の行を上にシフト
  rowToDelete.delete(ExcelScript.DeleteShiftDirection.up);
}

function main(workbook: ExcelScript.Workbook) {
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();

  // クリアするセル範囲 "B2:D4" を指定
  let range: ExcelScript.Range = sheet.getRange("B2:D4");

  // セル範囲のデータ、書式、ハイパーリンクをすべてクリア
  range.clear(ExcelScript.ClearApplyTo.all);
}

function main(workbook: ExcelScript.Workbook) {
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();

  // 値のみをクリアするセル範囲 "B2:D4" を指定
  let range: ExcelScript.Range = sheet.getRange("B2:D4");

  // セル範囲内のデータのみをクリア（書式とハイパーリンクは保持）
  range.clear(ExcelScript.ClearApplyTo.contents);
}

function main(workbook: ExcelScript.Workbook) {
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();

  // 対象となるセル範囲 "B2:D4" を指定
  let range: ExcelScript.Range = sheet.getRange("B2:D4");

  // セル範囲内のハイパーリンクのみを削除
  range.clear(ExcelScript.ClearApplyTo.hyperlinks);

  // 文字色と下線の書式をリセット
  range.getFormat().getFont().setColor("#000000"); // 文字色をデフォルトの黒に設定
  range.getFormat().getFont().setUnderline(ExcelScript.RangeUnderlineStyle.none); // 下線を削除
}

function main(workbook: ExcelScript.Workbook) {
  let sheet: ExcelScript.Worksheet = workbook.getActiveWorksheet();

  // 最終行と最終列を取得
  let lastRow: number = getLastDataRow(sheet); // 最終行を取得する関数を呼び出し
  let lastColumn: number = getLastDataColumn(sheet); // 最終行を取得する関数を呼び出し

  // 動的に取得したセル範囲内のデータのみをクリア
  let range: ExcelScript.Range = sheet.getRangeByIndexes(1, 1, lastRow - 1, lastColumn - 1); // B2から最終行・最終列まで
  range.clear(ExcelScript.ClearApplyTo.contents);
}


// ↓ 正確に最終行を求める関数
function getLastDataRow(sheet: ExcelScript.Worksheet): number {
  let usedRange: ExcelScript.Range = sheet.getUsedRange();
  if (!usedRange) return 0;

  let startRow: number = usedRange.getRowIndex();
  let rowCount: number = usedRange.getRowCount();
  let columnCount: number = usedRange.getColumnCount();

  for (let i: number = rowCount - 1; i >= 0; i--) {
    let rowIndex: number = startRow + i;
    let range: ExcelScript.Range = sheet.getRangeByIndexes(rowIndex, 0, 1, columnCount);
    let values = range.getValues()[0];

    // 行内の各セルをチェック
    if (values.some(cell => {
      if (cell === null || cell === undefined) {
        return 0;
      }
      if (typeof cell === 'string') {
        return cell.trim() !== "";
      }
      return true; // 数値やブール値など、非文字列型はデータありと判断
    })) {
      return rowIndex + 1;
    }
  }
  return 0;
}


// ↓ 正確に最終列を求める関数
function getLastDataColumn(sheet: ExcelScript.Worksheet): number {
  let usedRange: ExcelScript.Range = sheet.getUsedRange();
  if (!usedRange) return 0;

  let startColumn: number = usedRange.getColumnIndex();
  let rowCount: number = usedRange.getRowCount();
  let columnCount: number = usedRange.getColumnCount();

  for (let i: number = columnCount - 1; i >= 0; i--) {
    let columnIndex: number = startColumn + i;
    let range: ExcelScript.Range = sheet.getRangeByIndexes(0, columnIndex, rowCount, 1);
    let values = range.getValues();

    // 列内の各セルをチェック
    if (values.some(row => {
      let cell = row[0];
      if (cell === null || cell === undefined) {
        return 0;
      }
      if (typeof cell === 'string') {
        return cell.trim() !== "";
      }
      return true; // 数値やブール値など、非文字列型はデータありと判断
    })) {
      return columnIndex + 1;
    }
  }
  return 0;
}