GASでスプレッドシートの指定セルから文字色の詳細情報を取得する方法

Google Apps Script（GAS）を使ってスプレッドシートを操作しとると、文字色を取得したり、変更したりする場面に出くわすことがあるっちゃね。そんなときに便利なのが getFontColorObject() メソッドばい！

今回は、この getFontColorObject() の基本的な使い方から応用的な活用法まで、わかりやすく解説するけ。初心者でもしっかり理解できるようにまとめたばい！

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

posted with カエレバ

楽天市場

Amazon

Yahooショッピング

getFontColorObject() とは？
RGB値の取得と活用
16進数カラーコードへの変換
セル範囲のフォントカラーを一括取得
getFontColor() との違い
トラブルシューティング
1. デフォルト色取得の問題
まとめ

getFontColorObject() とは？

getFontColorObject() は、Googleスプレッドシートのセル内のフォントカラーをオブジェクト形式で取得できるメソッドじゃ。従来の getFontColor() では16進数の文字列（例：#ff0000）しか取得できんかったけど、新しいメソッドならRGB値やアルファ値（透明度）も扱えるとよ！

const colorObj = range.getFontColorObject();
const hexCode = colorObj.asRgbColor().asHexString(); // #RRGGBB形式

RGB値の取得と活用

このメソッドを使えば、フォントの色をRGB（赤・緑・青）の各成分に分解して取得できるっちゃね。たとえば、B2セルのフォントカラーを取得して、C2セルにRGB値として表示する方法を紹介するばい！

function getSingleCellRGB() {
  const sheet = SpreadsheetApp.getActive().getSheetByName('Data');
  const range = sheet.getRange("B2");
  const color = range.getFontColorObject().asRgbColor();
  
  const rgbValues = {
    red: color.getRed(),
    green: color.getGreen(),
    blue: color.getBlue()
  };
  
  sheet.getRange("C2").setValue(`RGB(${rgbValues.red},${rgbValues.green},${rgbValues.blue})`);
}

16進数カラーコードへの変換

ウェブデザインとの連携を考えると、16進数形式（#RRGGBB）のカラーコードを扱うことも多いっちゃろう。その場合は、次のように asHexString() を使うと便利ばい！

function convertToHex() {
  const cell = SpreadsheetApp.getActive().getRange('A1');
  const hex = cell.getFontColorObject().asHexString();
  
  Logger.log(`HEX Code: ${hex}`);
  return hex;
}

セル範囲のフォントカラーを一括取得

大規模データを扱う場合、セル1つ1つを処理するのは効率が悪かろう？そんなときは getFontColorObjects() を使うと、セル範囲全体のフォントカラーを一括で取得できるけ！

function processRangeColors() {
  const sheet = SpreadsheetApp.getActive().getSheetByName('SalesData');
  const dataRange = sheet.getRange("A2:F100");
  const colorMatrix = dataRange.getFontColorObjects();
  
  colorMatrix.forEach((row, rowIndex) => {
    row.forEach((colorObj, colIndex) => {
      if(colorObj.asHexString() === '#FF0000') {
        sheet.getRange(rowIndex+2, colIndex+1)
          .setNote('要確認: 赤文字項目');
      }
    });
  });
}

このスクリプトを使えば、赤文字（#FF0000）のセルに自動で「要確認」のメモを追加できるっちゃね！

getFontColor() との違い

getFontColor() では単純に #ff0000 のようなカラーコードしか取得できんかったばってん、 getFontColorObject() ならより細かい情報が取れるばい。

メソッド	取得できる情報
getFontColor()	16進数カラーコード（例：`#ff0000`）
getFontColorObject()	RGB値、透明度、オブジェクト操作可

移行するなら、次のようなコードを使うとスムーズじゃ！

// 旧方式
const oldColor = range.getFontColor(); // '#ff0000' など

// 新方式
const newColor = range.getFontColorObject().asHexString();

トラブルシューティング

デフォルト色取得の問題

明示的に色を設定してないセルは #ff000000（完全不透明の黒）として扱われることがあるっちゃ。これを回避するには、アルファ値（透明度）を考慮した処理を加えるとよかばい！

function handleDefaultColor() {
  const cell = SpreadsheetApp.getActive().getRange('A1');
  const color = cell.getFontColorObject().asRgbColor();
  
  // アルファ値を無視した処理
  const effectiveColor = color.asHexString().slice(0,7);
  Logger.log(effectiveColor);
}