GAS開発者向けにスプレッドシートのメモ機能をすべてまとめました。
Excelでいうコメント。メモ機能はかなり頻繁に使いますね。むしろ便利なので使うべきですね。
大量に仕込んだメモを一括で削除したり、いろんなセルに動的にメモを仕込みたい場合など、GASで実装するのが有効だと思います。
メモに関するメソッドをすべて載せてます。少しでも参考になれば幸いです。
Google Apps Script スプレッドシート 基礎 リファレンス
当ページは、GAS公式リファレンスを元にスプレッドシートの機能毎にまとめた基礎的な内容となっております。
若干、文言がおかしい可能性がありますが、あらかじめご了承ください。
GAS基本メソッドまとめ一覧はコチラ↓↓↓です。スプレッドシートの基本的な機能をまとめてますので、ぜひご活用ください。
まずは実際に動かしてみることをオススメします。マクロの登録方法は以下を参照いただければと思います。
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");
}
| 名前 | タイプ | 説明 |
|---|---|---|
| note | String | 範囲に設定するノート値。 null値はメモを削除します。 |
Return
Range - 連鎖用のセル範囲。
参照：Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | setNote(note)
メモ配列設定[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)
}
| 名前 | タイプ | 説明 |
|---|---|---|
| notes | Object[][] | メモの二次元配列。 null値はメモを削除します。 |
Return
Range - 連鎖用のセル範囲。
参照：Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | setNotes(notes)
セル範囲クラス[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 - 指定されたセルに関連付けられているメモ。
参照：Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | getNote()
メモ配列取得[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次元配列。
参照：Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | getNotes()
セル範囲リストクラス[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');
}
| 名前 | タイプ | 説明 |
|---|---|---|
| note | String | 設定するメモのテキスト。 null値はメモを削除します。 |
Return
RangeList - 連鎖用のセル範囲リスト。
参照：Google Apps Script | REFERENCE | SpreadSheet | Class RangeList | Methods | setNote(note)
最後に
GASメモ機能のまとめをご紹介させていただきました。
必要に応じて、有益な情報でさらに更新していきたいと思います。
プログラミングスキルを向上させるためには、本を読むだけでは脳にインプットされませんね。
実際に手を動かしてアウトプットしまくるのが一番の近道だと思います。
実際にサンプルソースをコピーして実行した結果がどうなるかを体験してみてください。
自分なりのアレンジを加えたり、なぜエラーになるのかを考え、何度も試行錯誤して問題を解決しまくり、着実に理解しながらスキルを向上させていきましょう。
GASはExcelVBAとはかなり違いますが、ベースとなっているJavaScriptは覚えて損はないプログラミング言語なのでショートカットキーなどと組み合わせてぜひ活用してみてください。
Googleスプレッドシート全ショートカットキー一覧はこちら↓↓↓
ショートカットキー一覧にもGASメソッドを載せています。どの操作からどのメソッドが呼ばれるのかイメージしてください。
コメント