Class Range

Intervallo

Una serie di elementi in un documento. La selezione dell'utente è rappresentata da Range, tra per altri usi. Gli script possono accedere solo alla selezione dell'utente che lo esegue e solo se lo script è legato al documento.

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

Metodi

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

Documentazione dettagliata

getRangeElements()

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

Invio

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