Class TextRange

TextRange

Un segmento dei contenuti testuali di un elemento Shape o 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)TextRangeAccoda una copia dell'intervallo di testo fornito alla fine dell'intervallo di testo corrente.
appendRange(textRange, matchSourceFormatting)TextRangeAccoda una copia dell'intervallo di testo fornito alla fine dell'intervallo di testo corrente.
appendText(text)TextRangeAggiunge testo alla fine dell'intervallo di testo.
asRenderedString()StringRestituisce il testo visualizzato limitato da questo intervallo della forma o della cella della tabella associata in un formato appropriato per essere mostrato agli utenti finali.
asString()StringRestituisce il testo non elaborato limitato 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 di inizio e fine dell'intervallo.
find(pattern)TextRange[]Restituisce tutti gli intervalli che corrispondono al pattern di ricerca nell'intervallo di testo corrente.
find(pattern, startOffset)TextRange[]Restituisce tutti gli intervalli che corrispondono 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 in base a 0 per l'ultimo carattere dell'intervallo.
getLength()IntegerRestituisce il numero di caratteri in questo intervallo.
getLinks()TextRange[]Restituisce una raccolta di intervalli di testo che corrisponde a tutti i valori Link all'interno dell'intervallo di testo corrente o che si sovrappongono all'intervallo di testo corrente.
getListParagraphs()Paragraph[]Restituisce i paragrafi negli elenchi che si sovrappongono all'intervallo di testo corrente.
getListStyle()ListStyleRestituisce il valore ListStyle dell'intervallo di testo corrente.
getParagraphStyle()ParagraphStyleRestituisce il valore 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 è derivato.
getRuns()TextRange[]Restituisce le esecuzioni di testo che si sovrappongono all'intervallo di testo corrente.
getStartIndex()IntegerRestituisce l'indice inclusivo basato su 0 per il primo carattere dell'intervallo.
getTextStyle()TextStyleRestituisce lo stile di testo dell'intervallo o null se l'intervallo è vuoto.
insertParagraph(startOffset, text)ParagraphInserisce un paragrafo in corrispondenza dell'offset iniziale.
insertRange(startOffset, textRange)TextRangeInserisce una copia dell'intervallo di testo fornito in corrispondenza dell'offset iniziale.
insertRange(startOffset, textRange, matchSourceFormatting)TextRangeInserisce una copia dell'intervallo di testo fornito in corrispondenza dell'offset iniziale.
insertText(startOffset, text)TextRangeInserisce il testo in corrispondenza dell'offset iniziale.
isEmpty()BooleanRestituisce true se non sono presenti caratteri in questo intervallo e, altrimenti, false.
replaceAllText(findText, replaceText)IntegerSostituisce tutte le istanze del testo che corrisponde al testo trovato con testo Sostituisci.
replaceAllText(findText, replaceText, matchCase)IntegerSostituisce tutte le istanze del testo che corrisponde al testo trovato con testo Sostituisci.
select()voidSeleziona solo TextRange nella presentazione attiva e rimuove eventuali selezioni precedenti.
setText(newText)TextRangeImposta il testo limitato 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 almeno un carattere di nuova riga circostante alla stringa.

Quando la stringa di testo fornita contiene caratteri di nuova riga (quindi sono composti da più paragrafi), viene restituito l'ultimo paragrafo aggiunto.

Parametri

NomeTipoDescrizione
textStringLa stringa da aggiungere come paragrafo.

Ritorni

Paragraph: l'elemento 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)

Accoda una copia dell'intervallo di testo fornito 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 aggiungere.

Ritorni

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)

Accoda una copia dell'intervallo di testo fornito alla fine dell'intervallo di testo corrente.

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

Parametri

NomeTipoDescrizione
textRangeTextRangeL'intervallo di testo da aggiungere.
matchSourceFormattingBooleanSe true, la formattazione del testo di origine corrisponde alla formattazione del testo di origine; se false, la formattazione del testo di destinazione.

Ritorni

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 testo alla fine dell'intervallo di testo. Il testo mantiene lo stile della fine del testo esistente.

Parametri

NomeTipoDescrizione
textStringLa stringa da aggiungere.

Ritorni

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 limitato da questo intervallo della forma o della cella della tabella associata in un formato appropriato per essere mostrato agli utenti finali.

Gli elementi di testo automatico, ad esempio i numeri delle slide generati, vengono sostituiti con i relativi valori visualizzati. Tutti gli elementi non testuali nell'intervallo vengono omessi.

Ritorni

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 limitato da questo intervallo della forma o della cella della tabella associata.

Gli elementi di testo automatico come i numeri delle slide generati ed eventuali elementi non testuali nell'intervallo vengono sostituiti con il carattere Unicode U+E907.

Ritorni

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 un oggetto Shape o TableCell deve terminare con una nuova riga, l'ultima riga del testo non viene rimossa.

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 di inizio e fine dell'intervallo.

Poiché il testo deve terminare con una nuova riga, l'ultima riga nel testo non viene rimossa anche se è coperta dagli offset specificati.

Parametri

NomeTipoDescrizione
startOffsetIntegerIl numero di caratteri oltre l'indice iniziale dell'intervallo di testo corrente utilizzato per determinare l'indice iniziale inclusivo dell'intervallo da cancellare. L'offset iniziale deve essere uguale o maggiore di 0 e minore o uguale a endOffset. Inoltre, startOffset deve essere inferiore 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 anche essere inferiore o uguale alla lunghezza dell'intervallo attuale.

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 che corrispondono al pattern di ricerca nell'intervallo di testo corrente. La ricerca è sensibile alle maiuscole.

Parametri

NomeTipoDescrizione
patternStringIl pattern di espressione regolare per la ricerca; qualsiasi barra rovesciata nel pattern deve essere preceduta da caratteri di escape.

Ritorni

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 che corrispondono 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 per la ricerca; qualsiasi barra rovesciata nel pattern deve essere preceduta da caratteri di escape.
startOffsetIntegerIl numero di caratteri oltre l'indice iniziale dell'intervallo di testo corrente utilizzato per determinare l'indice iniziale inclusivo dell'intervallo in cui cercare. Inoltre, startOffset deve essere inferiore alla lunghezza dell'intervallo corrente.

Ritorni

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.

Ritorni

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 in base a 0 per l'ultimo carattere dell'intervallo. Se gli indici iniziale e finale sono uguali, l'intervallo viene considerato vuoto.

Ritorni

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.

Ritorni

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 che corrisponde a tutti i valori Link all'interno dell'intervallo di testo corrente o che si sovrappongono all'intervallo di testo corrente.

È garantito che ogni intervallo restituito comprenda un solo link al momento della creazione. Le modifiche al testo possono far sì 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.
var linkTextRange = textRange.getLinks()[0];
var textStyle = linkTextRange.getTextStyle();
Logger.log(textStyle.hasLink()); // logs 'true'
var link = textStyle.getLink();  // Link object

Ritorni

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 negli elenchi che si sovrappongono all'intervallo di testo corrente.

Ritorni

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 valore ListStyle dell'intervallo di testo corrente.

Ritorni

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 valore ParagraphStyle dell'intervallo di testo corrente.

Ritorni

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.

Ritorni

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 è derivato.

Parametri

NomeTipoDescrizione
startOffsetIntegerIl numero di caratteri oltre l'indice iniziale dell'intervallo di testo corrente utilizzato per determinare l'indice iniziale inclusivo dell'intervallo restituito. L'offset iniziale deve essere uguale o maggiore di 0 e minore o uguale a endOffset. Inoltre, startOffset deve essere inferiore 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 anche essere inferiore o uguale alla lunghezza dell'intervallo attuale.

Ritorni

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 esecuzioni di testo che si sovrappongono all'intervallo di testo corrente. Un'esecuzione di testo è un segmento di testo in cui tutti i caratteri hanno lo stesso stile di testo.

Quando viene creato, ogni intervallo restituito copre un'unica esecuzione. Eventuali modifiche al testo o allo stile possono far sì che non rappresenti più esattamente un'esecuzione.

Ritorni

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 inclusivo basato su 0 per il primo carattere dell'intervallo. Se gli indici di inizio e fine sono uguali, l'intervallo viene considerato vuoto.

Ritorni

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 di testo dell'intervallo o null se l'intervallo è vuoto.

Ritorni

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 in corrispondenza dell'offset iniziale. Il paragrafo mantiene lo stile dell'intervallo di testo corrente all'inizio.

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

Quando la stringa di testo fornita contiene caratteri di nuova riga (quindi sono composti da più paragrafi), viene restituito l'ultimo paragrafo 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.

Ritorni

Paragraph: l'elemento 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 in corrispondenza dell'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.

Ritorni

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 in corrispondenza dell'offset iniziale.

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

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, la formattazione del testo di origine corrisponde alla formattazione del testo di origine; se false, la formattazione del testo di destinazione.

Ritorni

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 in corrispondenza dell'offset iniziale. Il testo mantiene lo stile del testo esistente in corrispondenza dell'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.

Ritorni

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, altrimenti, false.

Ritorni

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 del testo che corrisponde al testo trovato con testo Sostituisci. La ricerca non fa distinzione tra maiuscole e minuscole.

Parametri

NomeTipoDescrizione
findTextStringIl testo da trovare.
replaceTextStringIl testo da sostituire al testo corrispondente.

Ritorni

Integer: il numero di occorrenze è cambiato

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 del testo che corrisponde al testo trovato con testo Sostituisci.

Parametri

NomeTipoDescrizione
findTextStringIl testo da trovare.
replaceTextStringIl testo da sostituire al testo corrispondente.
matchCaseBooleanSe true, la ricerca è sensibile alle maiuscole; in false, la ricerca non fa distinzione tra maiuscole e minuscole.

Ritorni

Integer: il numero di occorrenze è cambiato

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()

Seleziona solo TextRange nella presentazione attiva e rimuove eventuali selezioni precedenti.

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

L'elemento Page principale del Shape o 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 Select in un TextRange non vuoto per selezionare l'intervallo di caratteri.
    • 2. Posizione del cursore, utilizza un valore TextRange vuoto per posizionare il cursore sull'indice desiderato.
      var 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 limitato 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.

    Ritorni

    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