GASでスプレッドシートの指定行の後ろに複数行を追加するには「insertRowsAfter(afterPosition,howMany)
」を利用する。
insertRowsAfter(afterPosition,howMany)
指定された行位置の後にいくつかの行を挿入します。
https://developers.google.com/apps-script/reference/spreadsheet/sheet?hl=en#insertrowsafterafterposition,-howmany
insertRowsAfter(afterPosition,howMany) のパラメーター
名前 | タイプ | 説明 |
---|---|---|
afterPosition | Integer | 新しい行を追加する必要がある行。 |
howMany | Integer | 挿入する行数。 |
スプレッドシートの指定行の後ろに複数行を追加するGAS
function myFunction() {
//アクティブなスプレッドシートを返す!
var ss = SpreadsheetApp.getActiveSpreadsheet();
//アクティブなスプレッドシートを取得!
var sht = ss.getActiveSheet();
//1~3行目までテキストを入力!
var rng = [
["1行目","BLUE1","Spreadhseet"],
["2行目","BLUE2","Spreadhseet"],
["3行目","BLUE3","Spreadhseet"]
];
//A1:C3にテキストをセットして背景を黄色に!
sht.getRange("A1:C3").setValues(rng).setBackground("yellow");
//insertRowsで挿入するafterPositionとhowManyを変数へ!
var num1 = 2; //afterPosition
var num2 = 3; //howMany
//insertRowsAfterで2行目以降に行を挿入!
sht.insertRowsAfter(num1,num2);
//insertRowsAfterで行挿入したことを背景色を白にしてお知らせ!
sht.getRange(3,1,3,3).setBackground("white").setValue("insertRowsAfterで挿入した行はここだぜ!");
}
スプレッドシートの指定行の後ろに複数行を追加するGAS実行の様子
insertRowsAfter(afterPosition,howMany) メソッドを利用して、スプレッドシートの指定行の後ろに複数行を追加するGASを実行してみました。
- A1:C3に配列でテキストを設置・背景色を黄色にして
- insertRowsAfterで2行目の後ろ~3行を挿入
- 挿入した行の背景色を白にしてテキストを設置
以上のようなスクリプト動作を実装してます。
スプレッドシートの指定行の後ろに複数行を追加するまとめ
GAS×スプレッドシートの指定行の後ろに複数行を追加するならinsertRowsAfter(afterPosition,howMany)
メソッドを利用しましょう。
参考記事:【GAS】スプレッドシートに行を挿入する
関連記事:【GAS】スプレッドシートを非表示にする
関連記事:【GAS】スプレッドシートを特定のシートにコピーする
【GAS】スプレッドシートで指定範囲をアクティブシートの選択セルに設定する
【GAS】スプレッドシートでアクティブな範囲のリストを取得する