Class TextRange

Intervallodi testo

Un segmento dei contenuti di testo di un Shape o di un TableCell.

Se utilizzi metodi che modificano la modalità di adattamento del testo all'interno di una forma, tutte le impostazioni di adattamento automatico applicate alla forma vengono disattivate.

Metodi

Metodo	Tipo restituito	Breve descrizione
appendParagraph(text)	Paragraph	Aggiunge un paragrafo alla fine dell'intervallo di testo.
appendRange(textRange)	TextRange	Collega una copia dell'intervallo di testo specificato alla fine dell'intervallo di testo corrente.
appendRange(textRange, matchSourceFormatting)	TextRange	Collega una copia dell'intervallo di testo specificato alla fine dell'intervallo di testo corrente.
appendText(text)	TextRange	Aggiunge del testo alla fine dell'intervallo di testo.
asRenderedString()	String	Restituisce il testo visualizzato delimitato da questo intervallo della forma o della cella della tabella associata in un formato appropriato per la visualizzazione agli utenti finali.
asString()	String	Restituisce il testo non elaborato delimitato da questo intervallo della forma o della cella della tabella associata.
clear()	void	Cancella il testo delimitato da questo intervallo.
clear(startOffset, endOffset)	void	Cancella il testo delimitato dagli offset iniziale e finale nell'intervallo.
find(pattern)	TextRange[]	Restituisce tutti gli intervalli corrispondenti al pattern di ricerca nell'intervallo di testo corrente.
find(pattern, startOffset)	TextRange[]	Restituisce tutti gli intervalli corrispondenti al pattern di ricerca nell'intervallo di testo corrente a partire dall'offset iniziale.
getAutoTexts()	AutoText[]	Restituisce i testi automatici nell'intervallo di testo corrente.
getEndIndex()	Integer	Restituisce l'indice esclusivo a partire da 0 per l'ultimo carattere in questo intervallo.
getLength()	Integer	Restituisce il numero di caratteri in questo intervallo.
getLinks()	TextRange[]	Restituisce una raccolta di intervalli di testo corrispondenti a tutti i Link all'interno dell'intervallo di testo corrente o che si sovrappongono all'intervallo di testo corrente.
getListParagraphs()	Paragraph[]	Restituisce i paragrafi degli elenchi che si sovrappongono all'intervallo di testo corrente.
getListStyle()	ListStyle	Restituisce il ListStyle dell'intervallo di testo corrente.
getParagraphStyle()	ParagraphStyle	Restituisce il ParagraphStyle dell'intervallo di testo corrente.
getParagraphs()	Paragraph[]	Restituisce i paragrafi che si sovrappongono all'intervallo di testo corrente.
getRange(startOffset, endOffset)	TextRange	Restituisce un nuovo TextRange che copre parte dell'intervallo da cui è dedotto.
getRuns()	TextRange[]	Restituisce le righe di testo che si sovrappongono all'intervallo di testo corrente.
getStartIndex()	Integer	Restituisce l'indice incluso a partire da 0 del primo carattere in questo intervallo.
getTextStyle()	TextStyle	Restituisce lo stile del testo dell'intervallo o null se l'intervallo è vuoto.
insertParagraph(startOffset, text)	Paragraph	Inserisce un paragrafo nell'offset di inizio.
insertRange(startOffset, textRange)	TextRange	Inserisce una copia dell'intervallo di testo fornito nell'offset iniziale.
insertRange(startOffset, textRange, matchSourceFormatting)	TextRange	Inserisce una copia dell'intervallo di testo fornito nell'offset iniziale.
insertText(startOffset, text)	TextRange	Inserisce il testo nell'offset iniziale.
isEmpty()	Boolean	Restituisce true se non sono presenti caratteri in questo intervallo e false altrimenti.
replaceAllText(findText, replaceText)	Integer	Sostituisce tutte le istanze di testo corrispondenti al testo trovato con il testo sostitutivo.
replaceAllText(findText, replaceText, matchCase)	Integer	Sostituisce tutte le istanze di testo corrispondenti al testo trovato con il testo sostitutivo.
select()	void	Consente di selezionare solo il TextRange nella presentazione attiva e di rimuovere qualsiasi selezione precedente.
setText(newText)	TextRange	Imposta il testo delimitato da questo intervallo della forma o della cella della tabella associata.

Documentazione dettagliata

appendParagraph(text)

Aggiunge un paragrafo alla fine dell'intervallo di testo. Il paragrafo mantiene lo stile della fine dell'intervallo di testo corrente.

La stringa di testo fornita viene aggiunta come paragrafo aggiungendo alla stringa almeno un carattere di riga nuova.

Quando la stringa di testo fornita contiene caratteri di nuova riga (quindi è composta da più paragrafi), viene restituito il paragrafo finale aggiunto.

Parametri

Nome	Tipo	Descrizione
text	String	La stringa da aggiungere come paragrafo.

Invio

Paragraph: il valore Paragraph aggiunto.

Autorizzazione

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

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

---

appendRange(textRange)

Collega una copia dell'intervallo di testo specificato alla fine dell'intervallo di testo corrente.

La formattazione del testo inserito corrisponderà a quella del testo di origine.

Parametri

Nome	Tipo	Descrizione
textRange	TextRange	L'intervallo di testo da accodare.

Invio

TextRange: l'intervallo di testo che rappresenta il testo aggiunto

Autorizzazione

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

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

---

appendRange(textRange, matchSourceFormatting)

Collega una copia dell'intervallo di testo specificato alla fine dell'intervallo di testo corrente.

Se impostato in modo da corrispondere alla formattazione del testo di destinazione, i AutoText all'interno dell'intervallo di testo fornito vengono sostituiti con i relativi valori visualizzati. Inoltre, eventuali elementi non di testo all'interno dell'intervallo di testo specificato non vengono aggiunti.

Parametri

Nome	Tipo	Descrizione
textRange	TextRange	L'intervallo di testo da accodare.
matchSourceFormatting	Boolean	Se true, applica la formattazione del testo di origine; se false, applica la formattazione del testo di destinazione.

Invio

TextRange: l'intervallo di testo che rappresenta il testo aggiunto

Autorizzazione

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

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

---

appendText(text)

Aggiunge del testo alla fine dell'intervallo di testo. Il testo mantiene lo stile della fine del testo esistente.

Parametri

Nome	Tipo	Descrizione
text	String	La stringa da accodare.

Invio

TextRange: l'intervallo di testo che rappresenta il testo aggiunto.

Autorizzazione

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

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

---

asRenderedString()

Restituisce il testo visualizzato delimitato da questo intervallo della forma o della cella della tabella associata in un formato appropriato per la visualizzazione agli utenti finali.

Gli elementi di testo automatico, come i numeri di diapositiva generati, vengono sostituiti con i relativi valori visualizzati. Eventuali elementi non di testo nell'intervallo vengono omessi.

Invio

String

Autorizzazione

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

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

---

asString()

Restituisce il testo non elaborato delimitato da questo intervallo della forma o della cella della tabella associata.

Gli elementi di testo automatici, come i numeri di diapositiva generati e gli elementi non di testo nell'intervallo, vengono sostituiti con il carattere Unicode U+E907.

Invio

String

Autorizzazione

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

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

---

clear()

Cancella il testo delimitato da questo intervallo.

Poiché l'intero testo in una forma o una cella della tabella deve terminare con un a capo, l'a capo finale nel testo non viene rimosso.

Autorizzazione

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

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

---

clear(startOffset, endOffset)

Cancella il testo delimitato dagli offset iniziale e finale nell'intervallo.

Poiché il testo deve terminare con un a capo, l'a capo finale nel testo non viene rimosso anche se è coperto dagli offset specificati.

Parametri

Nome	Tipo	Descrizione
startOffset	Integer	Il numero di caratteri oltre l'indice iniziale dell'intervallo di testo corrente utilizzato per determinare l'indice iniziale dell'intervallo da cancellare. L'offset iniziale deve essere uguale o maggiore di 0 e minore o uguale a endOffset. startOffset deve inoltre essere inferiore alla lunghezza dell'intervallo corrente.
endOffset	Integer	Il numero di caratteri oltre l'indice iniziale dell'intervallo di testo corrente utilizzato per determinare l'indice finale esclusivo dell'intervallo da cancellare. endOffset deve essere uguale o maggiore di startOffset. endOffset deve inoltre essere inferiore o uguale alla lunghezza dell'intervallo corrente.

Autorizzazione

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

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

---

find(pattern)

Restituisce tutti gli intervalli corrispondenti al pattern di ricerca nell'intervallo di testo corrente. La ricerca è sensibile alle maiuscole.

Parametri

Nome	Tipo	Descrizione
pattern	String	Il pattern di espressione regolare da cercare. Eventuali barre di sbarramento nel pattern devono essere sfuggite.

Invio

TextRange[]

Autorizzazione

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

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

---

find(pattern, startOffset)

Restituisce tutti gli intervalli corrispondenti al pattern di ricerca nell'intervallo di testo corrente a partire dall'offset iniziale. La ricerca è sensibile alle maiuscole.

Parametri

Nome	Tipo	Descrizione
pattern	String	Il pattern di espressione regolare da cercare. Eventuali barre di sbarramento nel pattern devono essere sfuggite.
startOffset	Integer	Il numero di caratteri oltre l'indice iniziale dell'intervallo di testo corrente utilizzato per determinare l'indice iniziale incluso dell'intervallo da cercare. startOffset deve essere anche inferiore alla lunghezza dell'intervallo corrente.

Invio

TextRange[]

Autorizzazione

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

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

---

getAutoTexts()

Restituisce i testi automatici nell'intervallo di testo corrente.

Invio

AutoText[]

Autorizzazione

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

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

---

getEndIndex()

Restituisce l'indice esclusivo a partire da 0 per l'ultimo carattere in questo intervallo. Se gli indici di inizio e di fine sono uguali, l'intervallo è considerato vuoto.

Invio

Integer

Autorizzazione

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

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

---

getLength()

Restituisce il numero di caratteri in questo intervallo.

Invio

Integer

Autorizzazione

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

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

---

getLinks()

Restituisce una raccolta di intervalli di testo corrispondenti a tutti i Link all'interno dell'intervallo di testo corrente o che si sovrappongono all'intervallo di testo corrente.

È garantito che ogni intervallo restituito si estenda su un link al momento della creazione. Le modifiche al testo possono fare in modo che non rappresenti più esattamente un link.

È possibile accedere a ogni Link negli intervalli restituiti tramite TextStyle.getLink().

// Accesses the first link on a TextRange object.
const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
const linkTextRange = textRange.getLinks()[0];
const textStyle = linkTextRange.getTextStyle();
Logger.log(textStyle.hasLink());   // logs 'true'
const link = textStyle.getLink();  // Link object

Invio

TextRange[]

Autorizzazione

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

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

---

getListParagraphs()

Restituisce i paragrafi degli elenchi che si sovrappongono all'intervallo di testo corrente.

Invio

Paragraph[]

Autorizzazione

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

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

---

getListStyle()

Restituisce il ListStyle dell'intervallo di testo corrente.

Invio

ListStyle

Autorizzazione

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

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

---

getParagraphStyle()

Restituisce il ParagraphStyle dell'intervallo di testo corrente.

Invio

ParagraphStyle

Autorizzazione

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

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

---

getParagraphs()

Restituisce i paragrafi che si sovrappongono all'intervallo di testo corrente.

Invio

Paragraph[]

Autorizzazione

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

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

---

getRange(startOffset, endOffset)

Restituisce un nuovo TextRange che copre parte dell'intervallo da cui è dedotto.

Parametri

Nome	Tipo	Descrizione
startOffset	Integer	Il numero di caratteri oltre l'indice iniziale dell'intervallo di testo corrente utilizzato per determinare l'indice iniziale dell'intervallo restituito. L'offset iniziale deve essere uguale o maggiore di 0 e minore o uguale a endOffset. startOffset deve essere inferiore anche alla lunghezza dell'intervallo corrente.
endOffset	Integer	Il numero di caratteri oltre l'indice iniziale dell'intervallo di testo corrente utilizzato per determinare l'indice finale esclusivo dell'intervallo restituito. endOffset deve essere uguale o maggiore di startOffset. endOffset deve inoltre essere inferiore o uguale alla lunghezza dell'intervallo corrente.

Invio

TextRange

Autorizzazione

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

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

---

getRuns()

Restituisce le righe di testo che si sovrappongono all'intervallo di testo corrente. Una corsa di testo è un segmento di testo in cui tutti i caratteri hanno lo stesso stile di testo.

È garantito che ogni intervallo restituito si estenda a una sola esecuzione al momento della creazione. Le modifiche al testo o allo stile possono causare la mancata rappresentazione di esattamente una corsa.

Invio

TextRange[]

Autorizzazione

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

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

---

getStartIndex()

Restituisce l'indice incluso a partire da 0 del primo carattere in questo intervallo. Se gli indici iniziale e finale sono uguali, l'intervallo è considerato vuoto.

Invio

Integer

Autorizzazione

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

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

---

getTextStyle()

Restituisce lo stile del testo dell'intervallo o null se l'intervallo è vuoto.

Invio

TextStyle

Autorizzazione

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

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

---

insertParagraph(startOffset, text)

Inserisce un paragrafo nell'offset di inizio. Il paragrafo mantiene lo stile dell'intervallo di testo corrente nell'offset iniziale.

La stringa di testo fornita viene inserita come paragrafo aggiungendo alla stringa almeno un carattere di riga nuova.

Quando la stringa di testo fornita contiene caratteri di nuova riga (quindi è composta da più paragrafi), viene restituito il paragrafo finale aggiunto.

Parametri

Nome	Tipo	Descrizione
startOffset	Integer	Il numero di caratteri oltre l'indice iniziale dell'intervallo di testo corrente utilizzato per determinare l'indice iniziale inclusivo del testo da inserire.
text	String	La stringa da inserire.

Invio

Paragraph: il Paragraph inserito.

Autorizzazione

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

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

---

insertRange(startOffset, textRange)

Inserisce una copia dell'intervallo di testo fornito nell'offset iniziale.

La formattazione del testo inserito corrisponderà a quella del testo di origine.

Parametri

Nome	Tipo	Descrizione
startOffset	Integer	Il numero di caratteri oltre l'indice iniziale dell'intervallo di testo corrente utilizzato per determinare l'indice iniziale inclusivo del testo da inserire.
textRange	TextRange	L'intervallo di testo da inserire.

Invio

TextRange: l'intervallo di testo che rappresenta il testo inserito

Autorizzazione

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

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

---

insertRange(startOffset, textRange, matchSourceFormatting)

Inserisce una copia dell'intervallo di testo fornito nell'offset iniziale.

Se impostato in modo da corrispondere alla formattazione del testo di destinazione, i AutoText all'interno dell'intervallo di testo fornito vengono sostituiti con i relativi valori visualizzati. Inoltre, eventuali elementi non di testo all'interno dell'intervallo di testo specificato non vengono inseriti.

Parametri

Nome	Tipo	Descrizione
startOffset	Integer	Il numero di caratteri oltre l'indice iniziale dell'intervallo di testo corrente utilizzato per determinare l'indice iniziale inclusivo del testo da inserire.
textRange	TextRange	L'intervallo di testo da inserire.
matchSourceFormatting	Boolean	Se true, applica la formattazione del testo di origine; se false, applica la formattazione del testo di destinazione.

Invio

TextRange: l'intervallo di testo che rappresenta il testo inserito

Autorizzazione

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

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

---

insertText(startOffset, text)

Inserisce il testo nell'offset iniziale. Il testo mantiene lo stile del testo esistente all'offset iniziale.

Parametri

Nome	Tipo	Descrizione
startOffset	Integer	Il numero di caratteri oltre l'indice iniziale dell'intervallo di testo corrente utilizzato per determinare l'indice iniziale inclusivo del testo da inserire.
text	String	La stringa da inserire.

Invio

TextRange: l'intervallo di testo che rappresenta il testo inserito.

Autorizzazione

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

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

---

isEmpty()

Restituisce true se non sono presenti caratteri in questo intervallo e false altrimenti.

Invio

Boolean

Autorizzazione

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

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

---

replaceAllText(findText, replaceText)

Sostituisce tutte le istanze di testo corrispondenti al testo trovato con il testo sostitutivo. La ricerca non fa distinzione tra maiuscole e minuscole.

Parametri

Nome	Tipo	Descrizione
findText	String	Il testo da trovare.
replaceText	String	Il testo da sostituire al testo corrispondente.

Invio

Integer: il numero di occorrenze modificate

Autorizzazione

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

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

---

replaceAllText(findText, replaceText, matchCase)

Sostituisce tutte le istanze di testo corrispondenti al testo trovato con il testo sostitutivo.

Parametri

Nome	Tipo	Descrizione
findText	String	Il testo da trovare.
replaceText	String	Il testo da sostituire al testo corrispondente.
matchCase	Boolean	Se true, la ricerca è sensibile alle maiuscole; se false, la ricerca è insensibile alle maiuscole.

Invio

Integer: il numero di occorrenze modificate

Autorizzazione

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

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

---

select()

Consente di selezionare solo il TextRange nella presentazione attiva e di rimuovere qualsiasi selezione precedente.

Uno script può accedere alla selezione dell'utente che lo esegue solo se è legato alla presentazione.

Il Page principale del Shape o del TableCell corrispondente è impostato come current page selection. Shape o TableCell è impostato come selected page element.

Selection può essere di due tipi:

• 1. Intervallo di testo, utilizza seleziona su un intervallo di testo non vuoto per selezionare l'intervallo di caratteri.
• 2. Posizione del cursore: utilizza un TextRange vuoto per posizionare il cursore nell'indice desiderato.

  const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
  shape.getText().setText('Hello');
  // Range selection: Select the text range "He".
  shape.getText().getRange(0, 2).select();
  // Cursor selection: Place the cursor after "H" like "H|ello".
  shape.getText().getRange(1, 1).select();

  Autorizzazione

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

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

---

setText(newText)

Imposta il testo delimitato da questo intervallo della forma o della cella della tabella associata. Il testo mantiene lo stile dell'inizio del testo esistente.

Parametri

Nome	Tipo	Descrizione
newText	String	La stringa da impostare come nuovo testo.

Invio

TextRange: l'intervallo di testo che rappresenta il testo impostato

Autorizzazione

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

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