GASでスプレッドシートの背景色を詳細情報付きで効率的に取得する方法

Googleスプレッドシートを使ってると、背景色を取得・変更したい場面ってあるばい？今回は、Google Apps Script（GAS）で背景色を扱うためのメソッド、特に**getBackgroundObjects()**について、分かりやすく解説していくけ！

詳解！Ｇｏｏｇｌｅ　Ａｐｐｓ　Ｓｃｒｉｐｔ完全入門ＧｏｏｇｌｅアプリケーションとＧｏｏｇｌｅ　Ｗｏｒ第３版/秀和システム/高橋宣成

posted with カエレバ

楽天市場

Amazon

Yahooショッピング

背景色を取得するメソッドの違い
Colorオブジェクトってなんね？
getBackgroundObjects()の実践活用
パフォーマンス比較
まとめ

背景色を取得するメソッドの違い

まず、背景色を取得するための主要メソッドを整理してみたさ。

メソッド名	返り値	処理範囲
getBackground()	RGB文字列（#ff0000）	単一セル
getBackgrounds()	RGB文字列の2次元配列	範囲内の全セル
getBackgroundObject()	Colorオブジェクト	単一セル
getBackgroundObjects()	Colorオブジェクトの2次元配列	範囲内の全セル

getBackgroundObjects()を使うと、Colorオブジェクトで色情報を取得できるけん、より詳細な色管理が可能になるばい。

Colorオブジェクトってなんね？

Colorオブジェクトは、RGBやテーマカラーの情報を持っとる便利なオブジェクトじゃ。例えば、こんな感じで使えるばい。

const range = SpreadsheetApp.getActiveRange();
const color = range.getBackgroundObject();
Logger.log(color.asRgbColor().asHexString()); // 例: #ff0000
Logger.log(color.getColorType()); // THEME/RGB/UNSUPPORTED

これを使えば、スプレッドシートのテーマカラーも考慮した色取得ができるさ。

getBackgroundObjects()の実践活用

実際に範囲内のセルの背景色を取得して、テーマカラーを確認するスクリプトを紹介するばい。

function checkThemeColors() {
  const range = SpreadsheetApp.getActiveRange();
  const colors = range.getBackgroundObjects();
  
  colors.forEach((row, i) => {
    row.forEach((colorObj, j) => {
      if (colorObj.getColorType() === SpreadsheetApp.ColorType.THEME) {
        Logger.log(`セル(${i+1},${j+1}) はテーマカラー: ${colorObj.asThemeColor().getThemeColorType()}`);
      }
    });
  });
}

このスクリプトを実行すると、選択範囲内でテーマカラーが使われているセルをログに表示するっちゃ。