Class Range

Zakres

Zakres elementów w dokumencie. Wybór użytkownika jest reprezentowany jako Range, wśród innych zastosowań. Skrypty mogą uzyskiwać dostęp tylko do elementów wybranych przez użytkownika, który uruchamia skrypt, i tylko wtedy, gdy skrypt jest powiązany z dokumentem.

// 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);
      }
    }
  }
}

Metody

MetodaZwracany typKrótki opis
getRangeElements()RangeElement[]Pobiera wszystkie elementy tego elementu Range, w tym elementy częściowe Text (np. w przypadku zaznaczenia obejmującego tylko część elementu Text).

Szczegółowa dokumentacja

getRangeElements()

Pobiera wszystkie elementy tego elementu Range, w tym elementy częściowe Text (np. w przypadku zaznaczenia obejmującego tylko część elementu Text). Aby sprawdzić, czy element Text jest tylko częściowo uwzględniony w zakresie, zapoznaj się z artykułem RangeElement.isPartial().

Powrót

RangeElement[] – tablica elementów w kolejności, w jakiej występują w dokumencie

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Wycofane metody