【GASスプレッドシート】getTextRotation()でテキスト回転を効率的に取得・SEO最適化

/**
 * アクティブなシートのB2セルのテキスト回転設定を取得し、ログに出力する関数。
 */
function getSingleCellTextRotation() {
  const sheet = SpreadsheetApp.getActiveSheet(); // アクティブなシートを取得
  const cell = sheet.getRange("B2");           // B2セルをRangeオブジェクトとして取得
  const textRotation = cell.getTextRotation();  // B2セルのTextRotationオブジェクトを取得
  
  // TextRotationオブジェクトから回転角度と縦書き状態を取得しログに出力
  Logger.log(`B2セルのテキスト回転角度: ${textRotation.getDegrees()}度`);
  Logger.log(`B2セルの縦書き状態: ${textRotation.isVertical() ? "有効" : "無効"}`);
}

/**
 * 複数範囲のセルのテキスト回転情報を一括取得し、ログに出力する関数。
 * getRange("B2:D4") の場合、[[B2の回転, C2の回転, D2の回転], [B3の回転, ...]] の形式で返されます。
 */
function getRangeTextRotations() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getRange("B2:D4"); // 対象範囲をB2:D4に設定
  const rotations = range.getTextRotations(); // 範囲内の全セルのTextRotationオブジェクトを一括取得
  
  Logger.log(`B2:D4範囲のテキスト回転情報:\n${JSON.stringify(rotations.map(row => row.map(r => ({degrees: r.getDegrees(), vertical: r.isVertical()}))), null, 2)}`);

  // 各セルのアドレスと共に回転角度と縦書き状態を出力する例
  rotations.forEach((rowRotations, rowIndex) => {
    rowRotations.forEach((cellRotation, colIndex) => {
      // getCell(row, column) は1から始まるインデックス
      const cellAddress = range.getCell(rowIndex + 1, colIndex + 1).getA1Notation();
      Logger.log(`セル ${cellAddress}: 角度 ${cellRotation.getDegrees()}度, 縦書き ${cellRotation.isVertical() ? "有効" : "無効"}`);
    });
  });
}

/**
 * 45度に回転したセルを自動で検索し、特定の背景色でハイライトする関数。
 */
function highlightSpecificRotations() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const dataRange = sheet.getDataRange(); // シート内のデータが存在する全範囲を取得
  const rotations = dataRange.getTextRotations(); // 全範囲のテキスト回転情報を一括取得
  
  Logger.log("45度回転のセルを検索し、ハイライト中...");

  rotations.forEach((rowRotations, rowIndex) => {
    rowRotations.forEach((cellRotation, colIndex) => {
      // getDegrees()で回転角度をチェック
      if (cellRotation.getDegrees() === 45) {
        // 該当セルをハイライト (例: 薄い黄色)
        sheet.getRange(dataRange.getRowIndex() + rowIndex, dataRange.getColumnIndex() + colIndex)
          .setBackground("#FFF2CC"); // setBackground() で背景色を設定
        Logger.log(`セル ${sheet.getRange(dataRange.getRowIndex() + rowIndex, dataRange.getColumnIndex() + colIndex).getA1Notation()} をハイライトしました (45度)。`);
      }
    });
  });
  Logger.log("ハイライト処理が完了しました。");
}

/**
 * 特定のセルのテキスト回転書式を、別のセル範囲に複製する関数。
 * 例: E5セルの回転設定をB2:D4範囲に適用します。
 */
function copyTextRotationFormat() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const sourceCell = sheet.getRange("E5"); // コピー元となるセル
  const targetRange = sheet.getRange("B2:D4"); // コピー先となる範囲
  
  const rotationTemplate = sourceCell.getTextRotation(); // コピー元のTextRotationオブジェクトを取得
  targetRange.setTextRotation(rotationTemplate); // コピー先の範囲に一括で設定
  Logger.log(`セル ${sourceCell.getA1Notation()} のテキスト回転設定を、範囲 ${targetRange.getA1Notation()} に複製しました。`);
}