Class Range

Диапазон

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

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

    // Only modify elements that can be edited as text; skip images and other
    // non-text elements.
    if (element.getElement().editAsText) {
      const 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);
      }
    }
  }
}

Методы

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

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

getRangeElements()

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

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

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

Авторизация

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

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

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