GASでスプレッドシートの指定範囲のすべての背景色情報を取得する方法

GASでスプレッドシートの範囲内の背景色情報を取得する方法
くら
くら

GASでスプレッドシートの範囲内の背景色情報を取得する方法を紹介します!

こんな人にむけた記事です。
  • GASを使って、スプレッドシートの範囲内の背景色情報を一括ですべて取得したい人
スポンサーリンク

範囲内の背景色情報を取得:getBackgroundObjects()

指定範囲の背景色情報をすべて取得します。

パラメータ

名前 タイプ 説明
なし なし なし

戻り値

Color[][]背景色情報の2次元配列

説明

function myFunction() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getSheetByName("サンプルA");
  const range = sheet.getRange("A2:C6");
  
  /* すべての背景色情報を取得 */
  const colors = range.getBackgroundObjects();
  
  /* すべての値を取得 */
  const values = range.getDisplayValues();
  
  /* 範囲内すべての背景色情報ログに出力する */
  for (let row in colors){
    for (let col in colors[row]){
      console.log(`${values[row][col]}のカラーコードは${colors[row][col].asRgbColor().asHexString()}`);
    }
  }
}

このような表の背景色情報を一括で取得してみます。

getbackgroundobjects - 背景を取得する表
背景を取得する表

コードを実行したときのログの内容です。

getbackgroundobjects - 取得結果のログ
取得結果のログ

公式ドキュメント:Range > getBackgroundObjects()

まとめ

くら
くら

スプレッドシートの範囲内の背景色情報を取得する方法でした!

  • 指定範囲すべての背景色情報を一括で取得することができます!

コメント

タイトルとURLをコピーしました