【GAS】スプレッドシートのセル水平配置を一括取得！getHorizontalAlignments()徹底解説

// 指定した範囲の水平配置情報を取得
const alignments = range.getHorizontalAlignments();

function sampleRetrieval() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getSheetByName('データシート');
  const range = sheet.getRange('B2:C3');
  const alignments = range.getHorizontalAlignments();
  
  alignments.forEach((row, rowIndex) => {
    row.forEach((alignment, colIndex) => {
      // セル番地を計算して表示
      const cellAddress = sheet.getRange(2 + rowIndex, 2 + colIndex).getA1Notation();
      console.log(`セル ${cellAddress}: ${alignment}`);
    });
  });
}

function bulkProcessing() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const dataRange = sheet.getDataRange();
  const alignData = dataRange.getHorizontalAlignments();
  
  // 右寄せのセルをハイライト
  alignData.forEach((row, i) => {
    row.forEach((align, j) => {
      if(align === 'right') {
        sheet.getRange(i + 1, j + 1).setBackground('#FFF3E0');
      }
    });
  });
}

function dynamicRangeHandling() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const lastRow = sheet.getLastRow();
  const lastCol = sheet.getLastColumn();
  
  if (lastRow <= 1 || lastCol <= 1) return; // データが少ない場合は処理しない

  const targetRange = sheet.getRange(2, 2, lastRow - 1, lastCol - 1);
  const alignMatrix = targetRange.getHorizontalAlignments();
  
  // 配置情報に基づいたデータ解析や処理をここに記述
  // analyzeAlignmentPatterns(alignMatrix);
}

function safeAlignmentRetrieval() {
  const range = SpreadsheetApp.getActiveRange();
  if (!range) return;

  try {
    const aligns = range.getHorizontalAlignments();
    
    // 配列の次元を検証
    if (aligns.length !== range.getNumRows() || 
        (aligns.length > 0 && aligns[0].length !== range.getNumColumns())) {
      throw new Error('取得したデータの次元が範囲と一致しません');
    }
    
    // 正常な場合の処理をここに記述
    
  } catch(e) {
    console.error(`エラーが発生しました: ${e.message}`);
    // エラー発生時の代替処理や再試行ロジックを実装
  }
}