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 ・・・新着記事一覧を見る

列全体を指定する時のRangeとColumnsの違い|ツイッター出題回答 (2023-09-24)
シートのActiveXチェックボックスの指定方法|ツイッター出題回答 (2023-09-24)
ByRef引数の型が一致しません。|ツイッター出題回答 (2023-09-22)
シートコピー後のアクティブシートは何か|ツイッター出題回答 (2023-09-19)
Excel関数の引数を省略した場合について|ツイッター出題回答 (2023-09-14)
セル個数を返すRange.CountLargeプロパティとは|VBA技術解説(2023-09-08)
記号を繰り返してグラフ作成(10単位で折り返す)|ツイッター出題回答 (2023-08-28)
シートを削除:不定数のシート名に対応|VBAサンプル集(2023-08-24)
ランクによりボイントを付ける(同順位はポイントを分割)|ツイッター出題回答 (2023-08-22)
OneDrive使用時のThisWorkbook.Pathの扱い方|VBA技術解説(2023-07-26)


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

1.最終行の取得(End,Rows.Count)|VBA入門
2.RangeとCellsの使い方|VBA入門
3.繰り返し処理(For Next)|VBA入門
4.変数宣言のDimとデータ型|VBA入門
5.セルのコピー&値の貼り付け(PasteSpecial)|VBA入門
6.マクロとは?VBAとは?VBAでできること|VBA入門
7.ブックを閉じる・保存(Close,Save,SaveAs)|VBA入門
8.並べ替え(Sort)|VBA入門
9.Range以外の指定方法(Cells,Rows,Columns)|VBA入門
10.条件分岐(IF)|VBA入門




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


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



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