В чем разница между getActiveRange () и getSelection ()?

Question

Кажется, что они оба делают одно и то же, возвращая выбранный диапазон на активном "открытом" листе. Что мне здесь не хватает? Есть ли случаи, когда вам нужно использовать getSelection ()?

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getActiveRange();    
var selection = sheet.getSelection();

// These return the same values
Logger.log("Range Values: %s", range.getValues());
Logger.log("Selection Values: %s", selection.getActiveRange().getValues());

// These also return the same values
Logger.log("Sheet Current Cell: %s", sheet.getCurrentCell().getValue());
Logger.log("Selection Current Cell: %s", selection.getCurrentCell().getValue());

Answer 1

Согласно документации, разница есть.

getActiveRange() возвращает диапазон классов, но getSelection() возвращает выбор класса. Разница в том, что выбор может быть несмежными диапазонами.

Итак, если вам нужно получить выбранные несмежные диапазоны, вам нужно будет использовать getSelection() Диапазон может быть только " группой смежных ячеек на листе "