GASで挿入するインデックスを指定してスプレッドシートに新規シートを挿入するには「insertSheet(sheetIndex)
」を利用する。
insertSheet(sheetIndex)
指定されたインデックスでスプレッドシートに新しいシートを挿入します。新しいシートがアクティブシートになります。
https://developers.google.com/apps-script/reference/spreadsheet/spreadsheet#insertsheetsheetindex
挿入するインデックスを指定してスプレッドシートに新規シートを挿入するGAS実行の様子
insertSheet(sheetIndex)メソッドを利用して、挿入するインデックスを指定してスプレッドシートに新規シートを挿入するGASを実行してみました。
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)のパラメーター
名前 | タイプ | 説明 |
---|---|---|
sheetIndex | Integer | 新しく作成されたシートのインデックス。スプレッドシートの最初のシートとしてシートを挿入するには、シートを0に設定します。 |
insertSheet(sheetIndex)の戻り値
Sheet—新しいシート。
挿入するインデックスを指定してスプレッドシートに新規シートを挿入するまとめ
GAS×挿入するインデックスを指定してスプレッドシートに新規シートを挿入するならinsertSheet(sheetIndex)
メソッドを利用しましょう。
関連記事:【GAS】スプレッドシートで指定した名前で新規シートを作成する
関連記事:【GAS】スプレッドシートのグリッド線を非表示にする
関連記事:【GAS】スプレッドシートをコピーして新規シートを作成する
関連記事:【GAS】スプレッドシートのアクティブシートを削除する
関連記事:【GAS】スプレッドシートで現在アクティブなシートを返す
関連記事:【GAS】スプレッドシートで名前・行・列数を指定して新規シートする
関連記事:【GAS】スプレッドシートのアクティブシートの名前を取得する