Доступ к текущему активному выбору на активном листе. Выделение — это набор ячеек, выделенных пользователем на листе, которые могут быть несмежными диапазонами. Одна ячейка в выделении — это текущая ячейка , в которой находится текущий фокус пользователя. Текущая ячейка выделяется более темной рамкой в пользовательском интерфейсе 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