GASでGoogleスプレッドシートのセルの値、行数や列数を取得したり、セルに値を入力したりする基本：Excel VBAプログラマーのためのGoogle Apps Script入門（2）（2/2 ページ）

» 2017年02月09日 05時00分公開

指定したセルに値を入力するsetValueメソッド

　続いて、セルに値を入力してみよう。

指定したセルに値を入力するsetValueメソッドの書式

var ｛戻り値｝=｛Rangeオブジェクト｝.setValue(｛入力値｝);

　値を入力するにはリスト2のように記述する。

function mysetValueFunction() {
  var sheet=SpreadsheetApp.getActiveSheet();
  sheet.getRange(11,1).setValue("松尾芭蕉");
}

リスト2　値の入力コード

　11行目の1列目に「松尾芭蕉」を追加した（3行目）。実行結果は図4のようになるだろう。

図4　1列目の11行目に「松尾芭蕉」が追加された

Rangeから1つのセルを相対位置で取得するgetCellメソッド

　Rangeオブジェクトには、さらに相対位置で1つのセルを選択できるgetCellメソッドがある。

Rangeから1つのセルを相対位置で取得するgetCellメソッドの書式

var ｛Rangeオブジェクト｝=｛Rangeオブジェクト｝.getCell(｛行番号｝,｛列番号｝)

　｛行番号｝｛列番号｝の指定は相対位置となる。例えば、図1から「猿飛佐助」の値を取得するには、リスト3のように書く。

function mygetCellFunction() {
  var sheet=SpreadsheetApp.getActiveSheet();
  
  var range=sheet.getRange("A2:A10");
  var cell=range.getCell(5,1).getValue();
  Browser.msgBox(cell);
}

リスト3　「猿飛佐助」の値を取得するコード

　選択している範囲は「A2:A10」であるため、「猿飛佐助」のセルは「A2」を起点として5行目に当たるということだ（4行目）。

　実行すると、図5のように表示される。

図5　「猿飛佐助」のデータを取得した

　ここでは、「5,1」のように指定したが、この部分を変数にし、後の連載で紹介するfor文などで、変数を変えていくことで値の取得や入力を一気に済ますことができるので、覚えておいてほしい。

行数や列数を取得する

　続いて、図6のような表を作成する。この表から行数や列数を取得する方法を解説する。行数や列数を取得できると、先ほど触れたfor文を使うときに便利なので、ぜひ覚えておいてほしい。

図6　氏名と年齢の表

行数を取得するgetNumRowsメソッド

Rangeから行数を取得するgetNumRowsメソッドの書式

var ｛戻り値｝=｛Rangeオブジェクト｝.getNumRows()

　図6から行数を取得するにはリスト4のように記述する

function mygetNumRowsFunction() {
  var sheet=SpreadsheetApp.getActiveSheet();
  var selectRange=sheet.getRange("A1:B11");
  var num=selectRange.getNumRows();
  Browser.msgBox(num);
}

リスト4　行数を取得するコード

　選択された範囲をA1～B11と指定して（3行目）、getNumRowsで行数を取得している（4行目）。

　実行すると図7のようになる。