【GAS】スプレッドシートのメモ機能まとめ【サンプルソース付】

GAS開発者向けにスプレッドシートのメモ機能をすべてまとめました。

Excelでいうコメント。メモ機能はかなり頻繁に使いますね。むしろ便利なので使うべきですね。

大量に仕込んだメモを一括で削除したり、いろんなセルに動的にメモを仕込みたい場合など、GASで実装するのが有効だと思います。

メモに関するメソッドをすべて載せてます。少しでも参考になれば幸いです。

Google Apps Script スプレッドシート基礎リファレンス
セル範囲クラス[Range]のメモ設定
1. メモ設定[setNote(メモ)]
2. メモ配列設定[setNotes(メモ's)]
セル範囲クラス[Range]のメモ取得
1. メモ取得[getNote()]
2. メモ配列取得[getNotes()]
セル範囲リストクラス[RangeList]のメモ設定
1. メモ設定[setNote(メモ)]
最後に

Google Apps Script スプレッドシート基礎リファレンス

当ページは、GAS公式リファレンスを元にスプレッドシートの機能毎にまとめた基礎的な内容となっております。

若干、文言がおかしい可能性がありますが、あらかじめご了承ください。

GAS基本メソッドまとめ一覧はコチラ↓↓↓です。スプレッドシートの基本的な機能をまとめてますので、ぜひご活用ください。

【GAS】スプレッドシート基本メソッドまとめ一覧【初心者入門】

GAS開発者向けにスプレッドシートの基本的なメソッドを一覧にまとめました。各機能ごとのクラス、メソッドごとのサンプルソース付ページへリンクする一覧です。初心者にとって、スプレッドシートの基本的な操作・機能単位のメソッドを知...

まずは実際に動かしてみることをオススメします。マクロの登録方法は以下を参照いただければと思います。

【GAS】Googleスプレッドシートでマクロの使い方入門【動画付】

Googleの「Google Apps Script」通称GAS。GoogleマップやGメールなど、いろんなGoogle関連のサービスと自由に連携できたり、独自のWebアプリを開発することもできる、いろんな可能性を秘めたワクワクの...

GASの本はまだまだ少ないですね。基礎レベルであれば、以下の参考書が初心者にはベストの本です。

基本的な仕様やよく使われる機能の設定方法がまとまっています。

リンク

※JavaScriptの知識が既にある程度ある人にとっては冗長かもしれません。

セル範囲クラス[Range]のメモ設定

セル範囲のメモ設定メソッドです。

メモ設定[setNote(メモ)]

setNote(note)
メモを指定された値に設定します。

function setNoteSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var cell = sheet.getRange("B2");
  cell.setNote("This is a note");
}

Parameters
名前	タイプ	説明
note	String	範囲に設定するノート値。 null値はメモを削除します。

Return
Range - 連鎖用のセル範囲。

メモ配列設定[setNotes(メモ's)]

setNotes(notes)
メモの2次元配列を設定します（この範囲のサイズと一致する必要があります）。

function setNotesSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  // 2次元配列のサイズは範囲のサイズと一致する必要があります。
  var notes = [
    ["it goes", "like this", "the fourth, the fifth"],
    ["the minor fall", "and the", "major lift"]
  ];

  var cell = sheet.getRange("B2:D3");
  cell.setNotes(notes)
}

Parameters
名前	タイプ	説明
notes	Object[][]	メモの二次元配列。 null値はメモを削除します。

Return
Range - 連鎖用のセル範囲。

セル範囲クラス[Range]のメモ取得

セル範囲のメモ取得メソッドです。

メモ取得[getNote()]

getNote()
与えられた範囲に関連したメモを返します。

function getNoteSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];
  var range = sheet.getRange("B2:D4");

  Logger.log(range.getNote());
}

Return
String - 指定されたセルに関連付けられているメモ。

メモ配列取得[getNotes()]

getNotes()
範囲内のセルに関連付けられているメモを返します。

function getNotesSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];
  var range = sheet.getRange("B2:D4");

  var results = range.getNotes();

  for (var i in results) {
    for (var j in results[i]) {
      Logger.log(results[i][j]);
    }
  }
}

Return
String[][] - 範囲内のセルに関連付けられているメモの2次元配列。

セル範囲リストクラス[RangeList]のメモ設定

セル範囲リストのメモ設定メソッドです。

メモ設定[setNote(メモ)]

setNote(note)
範囲リスト内の各範囲のメモテキストを設定します。

function setNoteSample() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var rangeList = sheet.getRangeListvar rangeList = sheet.getRangeList((['A:A', 'C:C']);
  rangeList.setNote('This is a note');
}