Class Selection

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Выбор

Доступ к текущему активному выбору на активном листе. Выделение — это набор ячеек, выделенных пользователем на листе, которые могут быть несмежными диапазонами. Одна ячейка в выделении — это текущая ячейка , в которой находится текущий фокус пользователя. Текущая ячейка выделяется более темной рамкой в ​​пользовательском интерфейсе Google Таблиц.

var activeSheet = SpreadsheetApp.getActiveSheet();
var rangeList = activeSheet.getRangeList(['A1:B4', 'D1:E4']);
rangeList.activate();

var selection = activeSheet.getSelection();
// Current Cell: D1
Logger.log('Current Cell: ' + selection.getCurrentCell().getA1Notation());
// Active Range: D1:E4
Logger.log('Active Range: ' + selection.getActiveRange().getA1Notation());
// Active Ranges: A1:B4, D1:E4
var ranges =  selection.getActiveRangeList().getRanges();
for (var i = 0; i < ranges.length; i++) {
  Logger.log('Active Ranges: ' + ranges[i].getA1Notation());
}
Logger.log('Active Sheet: ' + selection.getActiveSheet().getName());

Методы

Метод Тип возврата Краткое описание
getActiveRange() Range Возвращает выбранный диапазон на активном листе или null , если активного диапазона нет.
getActiveRangeList() RangeList Возвращает список активных диапазонов на активном листе или null , если активных диапазонов нет.
getActiveSheet() Sheet Возвращает активный лист электронной таблицы.
getCurrentCell() Range Возвращает текущую (выделенную) ячейку, выбранную в одном из активных диапазонов, или null , если текущей ячейки нет.
getNextDataRange(direction) Range Начиная с current cell и active range и двигаясь в заданном направлении, возвращает скорректированный диапазон, где соответствующий край диапазона был сдвинут, чтобы покрыть next data cell , но по-прежнему покрывает текущую ячейку.

Подробная документация

getActiveRange()

Возвращает выбранный диапазон на активном листе или null , если активного диапазона нет. Если выбрано несколько диапазонов, этот метод возвращает только последний выбранный диапазон.

var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
var activeRange = selection.getActiveRange();

Возвращаться

Range — активный диапазон

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getActiveRangeList()

Возвращает список активных диапазонов на активном листе или null , если активных диапазонов нет.

Если выбран один диапазон, это ведет себя как getActiveRange() .

var sheet = SpreadsheetApp.getActiveSheet();
// Returns the list of active ranges.
var activeRangeList = sheet.getActiveRangeList();

Возвращаться

RangeList — список активных диапазонов

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getActiveSheet()

Возвращает активный лист электронной таблицы.

var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
var activeSheet = selection.getActiveSheet();

Возвращаться

Sheet — активный лист в электронной таблице.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getCurrentCell()

Возвращает текущую (выделенную) ячейку, выбранную в одном из активных диапазонов, или null , если текущей ячейки нет.

var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
// Returns the current highlighted cell in the one of the active ranges.
var currentCell = selection.getCurrentCell();

Возвращаться

Range — текущая ячейка

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getNextDataRange(direction)

Начиная с current cell и active range и двигаясь в заданном направлении, возвращает скорректированный диапазон, где соответствующий край диапазона был сдвинут, чтобы покрыть next data cell , но по-прежнему покрывает текущую ячейку. Если активный диапазон не ограничен по dimension направления, возвращается исходный активный диапазон. Если текущей ячейки или активного диапазона нет, возвращается null . Это эквивалентно выбору диапазона в редакторе и нажатию Ctrl+Shift+[arrow key] .

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Makes C3 the current cell and C3:E5 the active range.
sheet.getRange("C3:E5").activate();
// Logs "C1:E3"
Logger.log(SpreadsheetApp.getSelection().getNextDataRange(Direction.UP).getA1Notation());

Параметры

Имя Тип Описание
direction Direction Направление, в котором нужно найти следующую граничную ячейку области данных.

Возвращаться

Range — скорректированный диапазон, включающий ячейку данных, или null , если выбор не сделан.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets