GAS PR

[GAS]セルのメモの内容を取得・設定する方法 -Rangeクラス-

記事内に商品プロモーションを含む場合があります

Google Apps Script (GAS) でこのセル範囲のセルのメモの内容を取得・設定する方法を説明します。

Rangeクラスのメソッドを利用した手順について説明します。

Google Apps Scriptの基本的な使い方については下記をご覧ください。

GASによるスプレッドシート操作の概要

GASでスプレッドシートを操作するための「SpreadSheetサービス」は、主に下記のクラスで構成されています。

クラス説明
SpreadSheetAppSpreadSheetサービスの親クラス
Spreadsheetスプレッドシートを操作するクラス
Sheetシートを操作するクラス
Rangeセル範囲を操作するクラス

それぞれ下記のような位置付けになります。

「SpreadSheetApp」→「SpreadSheet」→「Sheet」→「Range」という順の階層構造になっています。操作対象に応じて、下の階層にたどってオブジェクトを取得して利用します。

このページでは、上記の中のRangeクラスの下記のメソッドについて説明します。

メソッド戻り値説明
getNote()Stringこのセル範囲の左上セルのメモを取得する
getNotes()Stringこのセル範囲のセルのメモを配列で一括取得する
setNote(note)Rangeこのセル範囲のセルのメモを一括設定する
setNotes(notes)Rangeこのセル範囲のセルのメモを配列で一括設定する

このセル範囲のセルのメモを取得する

このセル範囲のセルのメモを取得するメソッドを説明します。

このセル範囲の左上セルのメモを取得する:getNote()

このセル範囲の左上セルのメモを取得する方法です。

下記のように実行します。

下記のファイルで実行してみます。

下記のような実行結果になります。左上セルのメモを取得できます。

このセル範囲のセルのメモを配列で一括取得する:getNotes()

このセル範囲のセルのメモを配列で一括取得する方法です。

下記のように実行します。

下記のファイルで実行してみます。

下記のような実行結果になります。セルのメモを配列で一括取得できます。

このセル範囲のセルのメモを設定する

このセル範囲のセルのメモを設定するメソッドを説明します。

このセル範囲のセルのメモを一括設定する:setNote(note)

このセル範囲のセルのメモを一括設定する方法です。

下記のように実行します。

下記のファイルで実行してみます。

下記のような実行結果になります。指定したセルのメモをすべて一括設定できます。

このセル範囲のセルのメモを配列で一括設定する:setNotes(notes)

このセル範囲のセルのメモを配列で一括設定する方法です。

下記のように実行します。

下記のファイルで実行してみます。

下記のような実行結果になります。指定したセルのメモを配列で一括設定できます。

実行後のgetNotesメソッドの出力結果は下記になります。

まとめ

Google Apps Script (GAS) でこのセル範囲のセルのメモの内容を取得・設定する方法を説明しました。

GASは無料で利用できてとても便利なツールです。

Googleスプレッドシート等のGoogleアプリケーションを利用されている方は、GASを習得することで作業を大きく効率化できます

GASの基本構文を知りたい方は、下記もご覧ください。