セル(Range)を選択(アクティブに)する

シート内の特定のセル(Range)を選択(アクティブに)するには、三通りの方法がある。
先ず、一つ目の方法は、SpreadsheetApp クラスの setActiveRange メソッドを用いるやり方
である。
  
  
【構文1】
SpreadsheetApp.setActiveRange(range)
  
range : Range 型。選択する Range オブジェクトを指定する。
戻り値 : Range 型。選択された Range オブジェクトが返される。
  
  
【例1】
function SetActiveRange1() {
  var objSpreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  var objSheet = objSpreadsheet.getActiveSheet();
  var objRange = objSheet.getRange("B12:H18");
  SpreadsheetApp.setActiveRange(objRange);
}
  
  
二つ目の方法は、Sheet クラスの setActiveRange メソッドを用いるやり方である。
  
  

【構文2】

SheetObject.setActiveRange(range)

  

range : Range 型。選択する Range オブジェクトを指定する。

戻り値 : Range 型。選択された Range オブジェクトが返される。

  

  

【例2】

function SetActiveRange2() {

  var objSpreadsheet = SpreadsheetApp.getActiveSpreadsheet();

  var objSheet = objSpreadsheet.getActiveSheet();

  var objRange = objSheet.getRange("B12:H18");

  objSheet.setActiveRange(objRange);

}

  

  

最後は Range オブジェクトの activate メソッドを用いた方法である。

  

  

【構文3】

RangeObject.activate()

  

戻り値 : Range 型。選択された Range オブジェクトが返される。

  

  

【例3】

function SetActiveRange3() {

  var objSpreadsheet = SpreadsheetApp.getActiveSpreadsheet();

  var objSheet = objSpreadsheet.getActiveSheet();

  var objRange = objSheet.getRange("B12:H18");

  objRange.activate();

}

  

  

以上、三通りの方法に共通していることは、いずれもアクティブなスプレッドシートのアクティブな

シートに対してのみ有効な点である。