GASでスプレッドシートに名前とインデックスを指定した新規シートを挿入するには「insertSheet(sheetName, sheetIndex)
」を利用する。
insertSheet(sheetName, sheetIndex)
指定されたインデックスで指定された名前の新しいシートをスプレッドシートに挿入します。新しいシートがアクティブシートになります。
https://developers.google.com/apps-script/reference/spreadsheet/spreadsheet#insertsheetsheetname,-sheetindex
スプレッドシートに名前とインデックスを指定した新規シートを挿入するGAS実行の様子
insertSheet(sheetName, sheetIndex)メソッドを利用して、スプレッドシートに名前とインデックスを指定した新規シートを挿入するGASを実行してみました。
insertSheet(sheetName, sheetIndex)
メソッドの()の値については
- sheetNameにはシート名(String)を
- sheetIndexにはインデックス数(Number)を
上記を指定することで、任意の位置に決め打ちしたシート名を挿入することが可能です。
insertSheet()
メソッドで指定した名前のシート挿入のみを行う場合は、以下記事を御覧ください。
参照記事:【GAS】スプレッドシートに指定した名前のシートを挿入する
スプレッドシートに名前とインデックスを指定した新規シートを挿入するGAS
function insertshtnameopt(){
//SpreadsheetAppを起動
var ss = SpreadsheetApp.getActiveSpreadsheet();
//YES・Noで確認
var yesno = Browser.msgBox("シート名・インデックスを指定して新規シートを挿入しますか?" ,Browser.Buttons.YES_NO_CANCEL);
//ーーーーー条件分岐ーーーーー
//YESだったら
if(yesno=="yes"){
//シート名を入力してもらう
var text = Browser.inputBox("挿入するシートの名前を入力してください");
//numを入力してもらう
var num = Browser.inputBox("挿入するシートのインデックスを入力してください(シート数以下の数値)");
//inputBoxの文字列を数値へ型変換
var n_num = Number(num);
//■insertSheetで名前とインデックスを指定した新規シートを挿入
ss.insertSheet(text,n_num);
//処理内容をメッセージで掲載
Browser.msgBox("「"+text+"」シートを「"+n_num+"」番目に挿入・Activeにしました!")
}else{
//Noのときの処理内容をメッセージで掲載
Browser.msgBox("新規シートの挿入はしませんでした。")
}
//ーーーーーここまでーーーーー
}
insertSheet(sheetName, sheetIndex)のパラメーター
名前 | タイプ | 説明 |
---|---|---|
sheetName | String | 新しいシートの名前。 |
sheetIndex | Integer | 新しく作成されたシートのインデックス。スプレッドシートの最初のシートとしてシートを挿入するには、シートを0に設定します。 |
insertSheet(sheetName, sheetIndex)の戻り値
Sheet—新しいシート。
スプレッドシートに名前とインデックスを指定した新規シートを挿入するまとめ
GAS×スプレッドシートに名前とインデックスを指定した新規シートを挿入するならinsertSheet(sheetName, sheetIndex)
メソッドを利用しましょう。
関連記事:【GAS】スプレッドシートで指定した名前で新規シートを作成する
関連記事:【GAS】スプレッドシートのグリッド線を非表示にする
関連記事:【GAS】スプレッドシートをコピーして新規シートを作成する
関連記事:【GAS】スプレッドシートのアクティブシートを削除する
関連記事:【GAS】スプレッドシートで現在アクティブなシートを返す
関連記事:【GAS】スプレッドシートで名前・行・列数を指定して新規シートする
関連記事:【GAS】スプレッドシートのアクティブシートの名前を取得する