Google Apps Script入門
複数のシートを扱う

Google Apps Script(GAS)の入門解説です
最終更新日:2022-11-04

第14回.複数のシートを扱う


スプレッドシートを使っていて、一つのシートで済むことはむしろ少ないと思います。


Google Apps Scriptで、複数のシートを扱う時のスクリプトの書き方になります。


複数のシートを扱う例題

シートは以下のように、
シート1
シート2
この2つがあるとして、
シート1がアクティブ
つまりシート1を選択している状態で、解説を進めます。

GAS スプレッドシートの参考画面

今までは、アクティブシートのみ扱ってきました。

var sheet = SpreadsheetApp.getActiveSheet()

これで、アクティブシートを取得していましたが、
この部分から根本的に書き方が変わります。

いきなり、シートを取得するのではなく、
まずは、
アクティブなスプレッドシート(ブック)を取得します。

var ash = SpreadsheetApp.getActiveSpreadsheet()

これで取得しているのは、あくまで、アクティブなスプレッドシート(ブック)になります。
そのブックの中にあるシートを取得するという事です。


シート名でシートを取得

「シート2」のA1セルに値を入れる。

function sample14_1() {
  var ash = SpreadsheetApp.getActiveSpreadsheet()
  var sheet = ash.getSheetByName("シート2")
  sheet.getRange(1, 1).setValue("やあ")
}

アクティブなスプレッドシート(ブック)を
var ash = SpreadsheetApp.getActiveSpreadsheet()
これで取得し、
その、アクティブなスプレッドシート(ブック)内の、
"シート2"というシートを、
var sheet = ash.getSheetByName("シート2")
これで取得しています。


インデックスでシートを取得

2番目のシートのA2セルに値を入れる。

function sample14_2() {
  var ash = SpreadsheetApp.getActiveSpreadsheet()
  var sheet = ash.getSheets()[1]
  sheet.getRange(2, 1).setValue("ども")
}
function sample14_3() {
  var ash = SpreadsheetApp.getActiveSpreadsheet()
  var sheets = ash.getSheets()
  sheets[1].getRange(3, 1).setValue("はい")
}

シートのインデックスは、0から始まります。
つまり、1番目のシートが0、2番目のシートが1になります。
インデックスは、[インデックス]のように、[]で記述します。
※Excelでは1から始まり()で記述しますので、要注意です。

2つのスクリプトは、どちらでも同じです。

前者は、
var sheet = ash.getSheets()[1]
これで、2番目のシートをいきなり取得しています。

後者は、
var sheets = ash.getSheets()
これで、シート全部(ここでは2つのシート)を取得し、
sheets[1]
この指定で、全シートの中の2番目のシートを取得しています。


シート数を取得

function sample14_4() {
  var ash = SpreadsheetApp.getActiveSpreadsheet()
  var i = ash.getSheets().length
  Browser.msgBox(i)
}

アクティブなスプレッドシート(ブック)を
var ash = SpreadsheetApp.getActiveSpreadsheet()
これで取得し、
その、アクティブなスプレッドシート(ブック)の中にあるシート数を
.length
で取得しています。


全シートを処理す

全シートのA1セルにシート名を入れる。

function sample14_5() {
  var ash = SpreadsheetApp.getActiveSpreadsheet()
  var sheets = ash.getSheets()
  for (i = 0; i < ash.getSheets().length; i++) {
    sheets[i].getRange(1, 1).setValue(sheets[i].getName())
  }
}

forで、0から、シート数 - 1 まで順に処理します。
※ゆくゆくは、for eachでの処理を掲載していきます。
forループのなかで、sheets[i]でシートを特定しています。


複数のシートの最後に

複数シートを扱う事は、スプレッドシートを扱う上で必須になります。

シート指定は、基本になりますので、しっかりと覚えて下さい。




同じテーマ「Google Apps Script入門」の記事

第11回.条件で処理を変える(条件分岐,switch)
第12回.表範囲をまとめて消去する
第13回.セルに書式を設定する
第14回.複数のシートを扱う
第15回.複数のスプレッドシートを扱う
第16回.Google Apps Scriptの文法
第17回.JavaScript リファレンス
第18回.組み込み関数を使う
第19回.いろいろな繰り返し処理
第20回.エラー処理(try・・・catch)
第21回.配列って何なんだ?


新着記事NEW ・・・新着記事一覧を見る

文字列のプロパティ名でオブジェクトを操作する方法|VBA技術解説(2022-12-14)
数字(1~50)を丸付き数字に変換するVBA|VBA技術解説(2022-11-15)
TEXTAFTER関数(テキストの指定文字列より後ろの部分を返す)|エクセル入門(2022-11-14)
TEXTBEFORE関数(テキストの指定文字列より前の部分を返す)|エクセル入門(2022-11-14)
TEXTSPLIT関数(列と行の区切り記号で文字列を分割)|エクセル入門(2022-11-12)
LAMBDA以降の新関数はVBAで使えるか|VBA技術解説(2022-11-11)
WRAPCOLS関数(1次元配列を指定数の列で折り返す)|エクセル入門(2022-11-08)
WRAPROWS関数(1次元配列を指定数の行で折り返す)|エクセル入門(2022-11-08)
EXPAND関数(配列を指定された行と列に拡張する)|エクセル入門(2022-11-07)
TAKE関数(配列の先頭/末尾から指定行/列数を取得)|エクセル入門(2022-11-06)


アクセスランキング ・・・ ランキング一覧を見る

1.最終行の取得(End,Rows.Count)|VBA入門
2.RangeとCellsの使い方|VBA入門
3.変数宣言のDimとデータ型|VBA入門
4.繰り返し処理(For Next)|VBA入門
5.セルのコピー&値の貼り付け(PasteSpecial)|VBA入門
6.Excelショートカットキー一覧|Excelリファレンス
7.並べ替え(Sort)|VBA入門
8.エクセルVBAでのシート指定方法|VBA技術解説
9.マクロって何?VBAって何?|VBA入門
10.繰り返し処理(Do Loop)|VBA入門




このサイトがお役に立ちましたら「シェア」「Bookmark」をお願いいたします。


記述には細心の注意をしたつもりですが、
間違いやご指摘がありましたら、「お問い合わせ」からお知らせいただけると幸いです。
掲載のVBAコードは動作を保証するものではなく、あくまでVBA学習のサンプルとして掲載しています。
掲載のVBAコードは自己責任でご使用ください。万一データ破損等の損害が発生しても責任は負いません。



このサイトがお役に立ちましたら「シェア」「Bookmark」をお願いいたします。
本文下部へ