シートに行を挿入する

シートに行を挿入するには五通りの方法がある。

先ず一つ目の方法は、Sheet クラスの insertRowAfter メソッドを用いる方法。このメソッドを

使用した場合、第一引数で指定した行の後の行に 1 行追加される。

  

  

【構文1】

SheetObject.insertRowAfter(rowindex)

  

rowindex : int 型。rowindex で指定した行の一つ後の行に追加される。

  

  

下記の例の場合は、9 行目と 10 行目の間に 1 行追加される。

  

  

【例1】

function InsertRowAfter() {

  var objSpreadsheet = SpreadsheetApp.getActiveSpreadsheet();

  var objSheet = objSpreadsheet.getActiveSheet();

  objSheet.insertRowAfter(9);

}

  

  

次は、Sheet クラスの insertRowBefore メソッドを用いる方法。このメソッドを使用した場合、
第一引数で指定した行の前の行に 1 行追加される。

  

  

【構文2】

SheetObject.insertRowBefore(rowindex )

  

rowindex : int 型。rowindex で指定した行の一つ前の行に追加される。

  

  

下記の例の場合は、8 行目と 9 行目の間に 1 行追加される。

  

  

【例2】

function InsertRowBefore() {

  var objSpreadsheet = SpreadsheetApp.getActiveSpreadsheet();

  var objSheet = objSpreadsheet.getActiveSheet();

  objSheet.insertRowBefore(9);

}

  
  

三番目の方法は、Sheet クラスの insertRowsAfter メソッドを用いるやり方。この場合は、第一

引数で指定した行の後ろに、第二引数で指定した行数を挿入する方法である。

  

  

【構文3】

SheetObject.insertRowsAfter(rowindex, numrows)

  

rowindex : int 型。rowindex で指定した行の一つ後の行に追加される。

numrows : int 型。追加したい行数を指定する。

  

  

下記の例は、9 行目と 10 行目の間に 4 行追加される例である。

  

  

【例3】

function InsertRowsAfter() {

  var objSpreadsheet = SpreadsheetApp.getActiveSpreadsheet();

  var objSheet = objSpreadsheet.getActiveSheet();

  objSheet.insertRowsAfter(9, 4);

}

  

  

四つ目の方法は、Sheet クラスの insertRowsBefore メソッドを用いるやり方。この場合は、
第一引数で指定した行の前の行に、第二引数で指定した行数を挿入する方法である。

  

  

【構文4】

SheetObject.insertRowsBefore(rowindex, numrows)

  

rowindex : int 型。rowindex で指定した行の一つ前の行に追加される。

numrows : int 型。追加したい行数を指定する。

  

  

下記の例は、8 行目と 9 行目の間に 4 行追加される例である。

  

  

【例4】

function InsertRowsBefore() {

  var objSpreadsheet = SpreadsheetApp.getActiveSpreadsheet();

  var objSheet = objSpreadsheet.getActiveSheet();

  objSheet.insertRowsBefore(9, 4);

}

  

  

最後は、Sheet クラスの insertRows メソッドを用いる方法である。これは insertRowsBefore
メソッド同様、第一引数で指定した行の前の行に、第二引数で指定した行数を挿入する方法で
ある。但し、第二引数を省略した場合は 1 と見なされる。
  
  
【構文5】
SheetObject.insertRows(rowindex [, numrows])
  
rowindex : int 型。rowindex で指定した行の一つ前の行に追加される。
numrows : int 型。省略可。追加したい行数を指定。省略の場合は 1 を指定したのと同じ。
  
  
下記の例の場合は、【例4】と全く同じ結果が得られる。
  
  
【例5】
function InsertRows() {
  var objSpreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  var objSheet = objSpreadsheet.getActiveSheet();
  objSheet.insertRows(9, 4);
}