Class Range

Диапазон

Диапазон элементов в документе. Выбор пользователя представлен в виде Range среди других применений. Сценарии могут получить доступ только к выбранному пользователю, который запускает сценарий, и только если сценарий привязан к документу. 

// Bold all selected text.
var selection = DocumentApp.getActiveDocument().getSelection();
if (selection) {
  var elements = selection.getRangeElements();
  for (var i = 0; i < elements.length; i++) {
    var element = elements[i];

    // Only modify elements that can be edited as text; skip images and other non-text elements.
    if (element.getElement().editAsText) {
      var text = element.getElement().editAsText();

      // Bold the selected part of the element, or the full element if it's completely selected.
      if (element.isPartial()) {
        text.setBold(element.getStartOffset(), element.getEndOffsetInclusive(), true);
      } else {
        text.setBold(true);
      }
    }
  }
}

Методы

Метод Тип возврата Краткое описание
getRangeElements() RangeElement[] Получает все элементы в этом Range , включая любые частичные элементы Text (например, в случае выделения, которое включает только часть элемента Text ).
Метод Тип возврата Краткое описание
getSelectedElements() RangeElement[] Получает все элементы, выбранные пользователем в открытом экземпляре документа, включая любые частично выбранные элементы Text .

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

getRangeElements()

Получает все элементы в этом Range , включая любые частичные элементы Text (например, в случае выделения, которое включает только часть элемента Text ). Чтобы определить, включен ли элемент Text в диапазон только частично, см. RangeElement.isPartial() .

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

RangeElement[] — массив элементов в том порядке, в котором они появляются в документе.

Авторизация

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

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

Устаревшие методы

Устарело. Переименован в getRangeElements() .

Получает все элементы, выбранные пользователем в открытом экземпляре документа, включая любые частично выбранные элементы Text .

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

RangeElement[] — массив выбранных или частично выбранных элементов в том порядке, в котором они появляются в документе.

Авторизация

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

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