行を操作する

【GAS】スプレッドシートの指定行の後ろに複数行を追加する

GASでスプレッドシートの指定行の後ろに複数行を追加するには「insertRowsAfter(afterPosition,howMany) 」を利用する。

insertRowsAfter(afterPosition,howMany)

指定された行位置の後にいくつかの行を挿入します。

https://developers.google.com/apps-script/reference/spreadsheet/sheet?hl=en#insertrowsafterafterposition,-howmany

参考記事:【GAS】スプレッドシートに複数行を挿入する

insertRowsAfter(afterPosition,howMany) のパラメーター

名前タイプ説明
afterPositionInteger新しい行を追加する必要がある行。
howManyInteger挿入する行数。
insertRowsAfter(afterPosition,howMany) のパラメーター

スプレッドシートの指定行の後ろに複数行を追加する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を実行してみました。

insertRowsAfter(afterPosition,howMany)
insertRowsAfter(afterPosition,howMany)で指定行の後ろに行を挿入する
  1. A1:C3に配列でテキストを設置・背景色を黄色にして
  2. insertRowsAfterで2行目の後ろ~3行を挿入
  3. 挿入した行の背景色を白にしてテキストを設置

以上のようなスクリプト動作を実装してます。

スプレッドシートの指定行の後ろに複数行を追加するまとめ

GAS×スプレッドシートの指定行の後ろに複数行を追加するならinsertRowsAfter(afterPosition,howMany) メソッドを利用しましょう。

参考記事:【GAS】スプレッドシートに行を挿入する

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

関連記事:【GAS】スプレッドシートを特定のシートにコピーする

【GAS】スプレッドシートでコンテンツをクリアする

【GAS】スプレッドシートで指定範囲をアクティブシートの選択セルに設定する

【GAS】スプレッドシートでアクティブな範囲のリストを取得する

【GAS】スプレッドシートの選択された範囲を取得する

【GAS】スプレッドシートのアクティブなセルを取得するgetCurrentCell編

【GAS】スプレッドシートのアクティブなセルを取得する

-行を操作する