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

MetodoTipo restituitoBreve descrizione
appendParagraph(text)ParagraphAggiunge un paragrafo alla fine dell'intervallo di testo.
appendRange(textRange)TextRangeCollega una copia dell'intervallo di testo specificato alla fine dell'intervallo di testo corrente.
appendRange(textRange, matchSourceFormatting)TextRangeCollega una copia dell'intervallo di testo specificato alla fine dell'intervallo di testo corrente.
appendText(text)TextRangeAggiunge del testo alla fine dell'intervallo di testo.
asRenderedString()StringRestituisce 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()StringRestituisce il testo non elaborato delimitato da questo intervallo della forma o della cella della tabella associata.
clear()voidCancella il testo delimitato da questo intervallo.
clear(startOffset, endOffset)voidCancella 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 all'interno dell'intervallo di testo corrente.
getEndIndex()IntegerRestituisce l'indice esclusivo a partire da 0 per l'ultimo carattere in questo intervallo.
getLength()IntegerRestituisce 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()ListStyleRestituisce il ListStyle dell'intervallo di testo corrente.
getParagraphStyle()ParagraphStyleRestituisce il ParagraphStyle dell'intervallo di testo corrente.
getParagraphs()Paragraph[]Restituisce i paragrafi che si sovrappongono all'intervallo di testo corrente.
getRange(startOffset, endOffset)TextRangeRestituisce 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()IntegerRestituisce l'indice incluso a partire da 0 per il primo carattere di questo intervallo.
getTextStyle()TextStyleRestituisce lo stile del testo dell'intervallo o null se l'intervallo è vuoto.
insertParagraph(startOffset, text)ParagraphInserisce un paragrafo nell'offset di inizio.
insertRange(startOffset, textRange)TextRangeInserisce una copia dell'intervallo di testo fornito nell'offset iniziale.
insertRange(startOffset, textRange, matchSourceFormatting)TextRangeInserisce una copia dell'intervallo di testo fornito nell'offset iniziale.
insertText(startOffset, text)TextRangeInserisce il testo nell'offset iniziale.
isEmpty()BooleanRestituisce true se non sono presenti caratteri in questo intervallo e false altrimenti.
replaceAllText(findText, replaceText)IntegerSostituisce tutte le istanze di testo corrispondenti al testo trovato con il testo sostitutivo.
replaceAllText(findText, replaceText, matchCase)IntegerSostituisce tutte le istanze di testo corrispondenti al testo trovato con il testo sostitutivo.
select()voidConsente di selezionare solo il TextRange nella presentazione attiva e di rimuovere qualsiasi selezione precedente.
setText(newText)TextRangeImposta 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

NomeTipoDescrizione
textStringLa 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

NomeTipoDescrizione
textRangeTextRangeL'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

NomeTipoDescrizione
textRangeTextRangeL'intervallo di testo da accodare.
matchSourceFormattingBooleanSe 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

NomeTipoDescrizione
textStringLa 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

NomeTipoDescrizione
startOffsetIntegerIl 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 essere inferiore anche alla lunghezza dell'intervallo corrente.
endOffsetIntegerIl 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

NomeTipoDescrizione
patternStringIl 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

NomeTipoDescrizione
patternStringIl pattern di espressione regolare da cercare. Eventuali barre di sbarramento nel pattern devono essere sfuggite.
startOffsetIntegerIl 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 all'interno dell'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

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

NomeTipoDescrizione
startOffsetIntegerIl 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.
endOffsetIntegerIl 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 per il primo carattere di 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

NomeTipoDescrizione
startOffsetIntegerIl numero di caratteri oltre l'indice iniziale dell'intervallo di testo corrente utilizzato per determinare l'indice iniziale inclusivo del testo da inserire.
textStringLa 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

NomeTipoDescrizione
startOffsetIntegerIl numero di caratteri oltre l'indice iniziale dell'intervallo di testo corrente utilizzato per determinare l'indice iniziale inclusivo del testo da inserire.
textRangeTextRangeL'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

NomeTipoDescrizione
startOffsetIntegerIl numero di caratteri oltre l'indice iniziale dell'intervallo di testo corrente utilizzato per determinare l'indice iniziale inclusivo del testo da inserire.
textRangeTextRangeL'intervallo di testo da inserire.
matchSourceFormattingBooleanSe 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

NomeTipoDescrizione
startOffsetIntegerIl numero di caratteri oltre l'indice iniziale dell'intervallo di testo corrente utilizzato per determinare l'indice iniziale inclusivo del testo da inserire.
textStringLa 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

NomeTipoDescrizione
findTextStringIl testo da trovare.
replaceTextStringIl 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

NomeTipoDescrizione
findTextStringIl testo da trovare.
replaceTextStringIl testo da sostituire al testo corrispondente.
matchCaseBooleanSe 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

    NomeTipoDescrizione
    newTextStringLa 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