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
Metodo | Tipo restituito | Breve 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