Class RangeElement

ДиапазонЭлемент

Обертка вокруг Element с возможным смещением начала и конца. Эти смещения позволяют представлять диапазон символов внутри элемента Text в результатах поиска, выделенных документах и ​​именованных диапазонах.

Методы

Метод Тип возврата Краткое описание
getElement() Element Получает Element , соответствующий этому RangeElement .
getEndOffsetInclusive() Integer Получает позицию конца частичного диапазона внутри элемента диапазона.
getStartOffset() Integer Получает позицию начала частичного диапазона внутри элемента диапазона.
isPartial() Boolean Определяет, охватывает ли этот элемент диапазона весь элемент или частичный набор символов элемента.

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

getElement()

Получает Element , соответствующий этому RangeElement .

// Log debug information about a range element.
Logger.log('Element type: ' + rangeElement.getElement().getType());
if (rangeElement.isPartial()) {
  Logger.log('The character range begins at ' + rangeElement.getStartOffset());
  Logger.log('The character range ends at ' + rangeElement.getEndOffsetInclusive());
} else {
  Logger.log('The entire range element is included.');
}

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

Element — элемент, соответствующий этому RangeElement

Авторизация

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

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

getEndOffsetInclusive()

Получает позицию конца частичного диапазона внутри элемента диапазона. Если элемент является элементом Text и isPartial() возвращает true , смещение — это количество символов перед последним символом в диапазоне (то есть индекс последнего символа в диапазоне); в любом другом случае этот метод возвращает -1 .

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

Integer — для Text элементов количество символов перед последним символом диапазона; для остальных элементов -1

Авторизация

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

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

getStartOffset()

Получает позицию начала частичного диапазона внутри элемента диапазона. Если элемент является элементом Text и isPartial() возвращает true , смещение — это количество символов до начала диапазона (то есть индекс первого символа в диапазоне); в любом другом случае этот метод возвращает -1 .

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

Integer — для Text элементов количество символов до начала диапазона; для остальных элементов -1

Авторизация

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

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

isPartial()

Определяет, охватывает ли этот элемент диапазона весь элемент или частичный набор символов элемента. Начало и конец диапазона элемента частичного диапазона можно определить с помощью getStartOffset() и getEndOffsetInclusive() соответственно.

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

Booleantrue , если элемент включен частично; false если нет

Авторизация

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

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