シートを操作する

【GAS】挿入するインデックスを指定してスプレッドシートに新規シートを挿入する

GASで挿入するインデックスを指定してスプレッドシートに新規シートを挿入するには「insertSheet(sheetIndex)」を利用する。

insertSheet(sheetIndex)

指定されたインデックスでスプレッドシートに新しいシートを挿入します。新しいシートがアクティブシートになります。

https://developers.google.com/apps-script/reference/spreadsheet/spreadsheet#insertsheetsheetindex

挿入するインデックスを指定してスプレッドシートに新規シートを挿入するGAS実行の様子

insertSheet(sheetIndex)メソッドを利用して、挿入するインデックスを指定してスプレッドシートに新規シートを挿入するGASを実行してみました。

insertSheet(sheetIndex)を実行した場合

inserSheet(sheetIndex)を利用する際の注意点として、

  • ()の値を指定したとき、
  • 指定した値がシートの名前になる

といった動作になる点でしょう。

insertSheet()メソッドでインデックス数と名前を付与したい場合は、以下記事を御覧ください。

参照記事:スプレッドシートにインデックスとオプションを指定した新規シートを挿入する

挿入するインデックスを指定してスプレッドシートに新規シートを挿入するGAS

function insertindex(){
  //SpreadsheetAppを起動
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  //YES・NOを設定
 var result = Browser.msgBox("新規シートを挿入しますか?",Browser.Buttons.YES_NO_CANCEL);

 //ーーーーー条件分岐ーーーーー
  //YESだったら
   if(result == "yes"){
    //index数を入力してもらう
    var index = Browser.inputBox("シートを挿入したいIndex数(0 or 1)を入力してください");
    //■insertSheetでindex数に新規シートを作成・挿入
    ss.insertSheet(index);
    //メッセージで作成・挿入したシートの名前を掲載
     Browser.msgBox("シート新規作成・挿入しました!")
    } else {
    //キャンセルした旨を掲載
     Browser.msgBox("シートの新規挿入をキャンセルしました。")
    }
 //ーーーーーここまでーーーーー
}

insertSheet(sheetIndex)のパラメーター

名前タイプ説明
sheetIndexInteger新しく作成されたシートのインデックス。スプレッドシートの最初のシートとしてシートを挿入するには、シートを0に設定します。
insertSheet(sheetIndex)のパラメーター

insertSheet(sheetIndex)の戻り値

Sheet—新しいシート。

挿入するインデックスを指定してスプレッドシートに新規シートを挿入するまとめ

GAS×挿入するインデックスを指定してスプレッドシートに新規シートを挿入するならinsertSheet(sheetIndex)メソッドを利用しましょう。

関連記事:【GAS】スプレッドシートで指定した名前で新規シートを作成する

関連記事:【GAS】スプレッドシートのグリッド線を非表示にする

関連記事:【GAS】スプレッドシートのシート名を変更する

関連記事:【GAS】スプレッドシートをコピーして新規シートを作成する

関連記事:【GAS】スプレッドシートのアクティブシートを削除する

関連記事:【GAS】スプレッドシートで現在アクティブなシートを返す

関連記事:【GAS】スプレッドシートで名前・行・列数を指定して新規シートする

関連記事:【GAS】スプレッドシートのアクティブシートの名前を取得する

関連記事:【GAS】スプレッドシートでアクティブなシートを返す

関連記事:【GAS】スプレッドシートでアクティブなシートを取得する

-シートを操作する