Class Range

Intervallo

Un intervallo di elementi in un documento. La selezione dell'utente viene rappresentata come un Range, tra gli altri utilizzi. Gli script possono accedere solo alla selezione dell'utente che li esegue e solo se sono associati al documento. 

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

Metodi

MetodoTipo restituitoBreve descrizione
getRangeElements()RangeElement[]Recupera tutti gli elementi in questo Range, inclusi gli elementi Text parziali (ad esempio, nel caso di una selezione che include solo una parte di un elemento Text).

Documentazione dettagliata

getRangeElements()

Recupera tutti gli elementi in questo Range, inclusi gli elementi Text parziali (ad esempio, nel caso di una selezione che include solo una parte di un elemento Text). Per determinare se un elemento Text è incluso solo parzialmente nell'intervallo, consulta RangeElement.isPartial().

Indietro

RangeElement[] : un array di elementi, nell'ordine in cui appaiono nel documento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

Metodi ritirati