GAS `getWrap()` / `getWraps()`徹底解説！スプレッドシートのテキスト折り返しを自動調整

/**
 * アクティブなシートのB2セルのテキスト折り返し状態を取得し、ログに出力する関数。
 * 返り値は true（折り返しあり）または false（折り返しなし）です。
 */
function getSingleCellWrapStatus() {
  const sheet = SpreadsheetApp.getActiveSheet(); // アクティブなシートを取得
  const cell = sheet.getRange("B2");           // B2セルをRangeオブジェクトとして取得
  const isWrapped = cell.getWrap();             // B2セルのテキスト折り返し状態を取得
  
  // 取得した状態をログに出力
  Logger.log(`B2セルのテキスト折り返し状態: ${isWrapped ? "有効" : "無効"}`);
}

/**
 * 複数範囲のセルのテキスト折り返し状態を一括取得し、ログに出力する関数。
 * getRange("A1:C10") の場合、[[true, false, true], [false, ...]] の形式で返されます。
 */
function getRangeWrapStatus() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getRange("A1:C10"); // 対象範囲をA1:C10に設定
  const wrapStates = range.getWraps();   // 範囲内の全セルの折り返し状態を一括取得
  
  Logger.log(`A1:C10範囲のテキスト折り返し状態:\n${JSON.stringify(wrapStates, null, 2)}`);

  // 各セルのアドレスと共に折り返し状態を出力する例
  wrapStates.forEach((rowStates, rowIndex) => {
    rowStates.forEach((isWrapped, colIndex) => {
      // getCell(row, column) は1から始まるインデックス
      const cellAddress = range.getCell(rowIndex + 1, colIndex + 1).getA1Notation();
      if (!isWrapped) { // 折り返しが「無効」のセルを検出
        Logger.log(`セル ${cellAddress} で折り返し未設定を検出しました。`);
      }
    });
  });
}

/**
 * データ範囲内のセルのテキスト長に応じて、テキスト折り返し設定を動的に調整する関数。
 * テキスト長が50文字を超えるセルは「折り返し（true）」に設定します。
 */
function applyDynamicWrappingBasedOnLength() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const dataRange = sheet.getDataRange();       // シート内のデータが存在する全範囲を取得
  const values = dataRange.getValues();         // 全範囲のセル値を取得（テキスト長取得用）
  const newWrapStates = [];                     // 新しい折り返し設定を格納する二次元配列

  values.forEach(rowValues => {
    const rowWrapStates = [];
    rowValues.forEach(cellValue => {
      // セル値のテキスト長に基づいて折り返し設定を決定
      if (String(cellValue).length > 50) { // 例: 50文字を超える場合
        rowWrapStates.push(true);        // 折り返しを有効に
      } else {
        rowWrapStates.push(false);       // 折り返しを無効に (オーバーフロー/切り詰め)
      }
    });
    newWrapStates.push(rowWrapStates);
  });
  
  // 生成した新しい折り返し設定を一括でシートに適用
  dataRange.setWraps(newWrapStates);
  Logger.log("テキスト長に応じてテキスト折り返し設定を自動調整しました。");
}

/**
 * 大規模なデータ範囲のテキスト折り返し設定を、バッチ処理で効率的に取得・設定する関数。
 * 例: 1000行ごとにまとめてテキスト折り返しを有効にします。
 */
function processLargeRangeWrapEfficiently() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const lastRow = sheet.getLastRow();      // データが入力されている最終行番号を取得
  const lastColumn = sheet.getLastColumn(); // データが入力されている最終列番号を取得
  const batchSize = 1000;                  // 一度に処理する行のバッチサイズ
  
  Logger.log(`シートの最終行: ${lastRow}, 最終列: ${lastColumn}, チャンクサイズ: ${batchSize}`);

  for (let i = 1; i <= lastRow; i += batchSize) {
    const currentBatchNumRows = Math.min(batchSize, lastRow - i + 1); // 現在のチャンクの行数を計算
    // 現在のチャンクの範囲を取得 (例: A1:Z1000, A1001:Z2000 ...)
    const batchRange = sheet.getRange(i, 1, currentBatchNumRows, lastColumn); 
    
    // チャンク範囲のすべてのセルに対してテキスト折り返しを有効に設定
    // setWrap() はRangeオブジェクト全体に同じ設定を適用するため、二次元配列は不要
    batchRange.setWrap(true);  
    
    Logger.log(`  チャンク処理済み: ${i}行目から${i + currentBatchNumRows - 1}行目`);
    // Utilities.sleep(50); // 必要に応じてAPI呼び出し間隔を調整し、API制限回避に役立てる
  }
  Logger.log("大規模データのテキスト折り返し設定が効率的に処理されました。");
}

/**
 * getWrap()関連メソッド使用時のエラーを捕捉し、ログに出力するデバッグ関数。
 */
function debugWrapMethods() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const targetRangeAddress = "A1:C5"; // 存在する範囲を想定

  try {
    const range = sheet.getRange(targetRangeAddress);
    Logger.log(`対象範囲: ${range.getA1Notation()}`);
    
    const initialWrapState = range.getWrap(); // getWrap() で単一セルの状態を取得
    Logger.log(`初期折り返し状態 (A1): ${initialWrapState ? "有効" : "無効"}`);

    const initialWrapStates = range.getWraps(); // getWraps() で範囲の状態を一括取得
    Logger.log(`初期折り返し状態 (範囲全体):\n${JSON.stringify(initialWrapStates, null, 2)}`);
    
    range.setWrap(true); // 範囲全体に折り返しを有効に設定
    SpreadsheetApp.flush(); // 変更を即時反映

    const afterSetWrapState = range.getWrap();
    Logger.log(`setWrap(true)後の状態 (A1): ${afterSetWrapState ? "有効" : "無効"}`);
    
  } catch (error) {
    Logger.error(`エラーが発生しました: ${error.message}`);
    // 必要に応じて、ユーザーにエラーを通知するUIを表示
    // SpreadsheetApp.getUi().alert('エラー', `スクリプト実行中に問題が発生しました: ${error.message}`, SpreadsheetApp.getUi().ButtonSet.OK);
  }
}