Class TextRange

TextRange

Un segmento dei contenuti testuali di un elemento Shape o TableCell.

Se utilizzi metodi che modificano il modo in cui il testo si adatta a una forma, qualsiasi impostazione di adattamento automatico applicata a la forma viene disattivata.

Metodi

MetodoTipo restituitoBreve descrizione
appendParagraph(text)ParagraphConsente di aggiungere un paragrafo alla fine dell'intervallo di testo.
appendRange(textRange)TextRangeAggiunge una copia dell'intervallo di testo fornito alla fine dell'intervallo di testo corrente.
appendRange(textRange, matchSourceFormatting)TextRangeAggiunge una copia dell'intervallo di testo fornito alla fine dell'intervallo di testo corrente.
appendText(text)TextRangeAggiunge il testo alla fine dell'intervallo di testo.
asRenderedString()StringRestituisce il testo visualizzato limitato da questo intervallo della forma o cella di tabella associata in una appropriato da mostrare agli utenti finali.
asString()StringRestituisce il testo non elaborato limitato da questo intervallo della forma o della cella di tabella associata.
clear()voidCancella il testo limitato da questo intervallo.
clear(startOffset, endOffset)voidCancella il testo delimitato dagli offset di inizio e fine nell'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 dalla offset iniziale.
getAutoTexts()AutoText[]Restituisce i testi automatici all'interno dell'intervallo di testo corrente.
getEndIndex()IntegerRestituisce l'indice esclusivo in base 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 che corrispondono a tutti i valori Link all'interno dell'intervallo a un intervallo di testo 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 valore TextRange che copre parte dell'intervallo da cui deriva.
getRuns()TextRange[]Restituisce le esecuzioni di testo che si sovrappongono all'intervallo di testo corrente.
getStartIndex()IntegerRestituisce l'indice incluso in base 0 per il primo carattere di questo intervallo.
getTextStyle()TextStyleRestituisce lo stile di testo dell'intervallo o null se l'intervallo è vuoto.
insertParagraph(startOffset, text)ParagraphInserisce un paragrafo all'offset iniziale.
insertRange(startOffset, textRange)TextRangeInserisce una copia dell'intervallo di testo fornito all'offset iniziale.
insertRange(startOffset, textRange, matchSourceFormatting)TextRangeInserisce una copia dell'intervallo di testo fornito all'offset iniziale.
insertText(startOffset, text)TextRangeInserisce il testo all'offset iniziale.
isEmpty()BooleanRestituisce true se non ci sono caratteri in questo intervallo e restituisce false negli altri casi.
replaceAllText(findText, replaceText)IntegerSostituisce tutte le istanze di testo corrispondenti a Trova testo con Sostituisci testo.
replaceAllText(findText, replaceText, matchCase)IntegerSostituisce tutte le istanze di testo corrispondenti a Trova testo con Sostituisci testo.
select()voidSeleziona solo il TextRange nella presentazione attiva e rimuove gli eventuali selezione.
setText(newText)TextRangeImposta il testo delimitato da questo intervallo della forma o della cella di tabella associata.

Documentazione dettagliata

appendParagraph(text)

Consente di aggiungere un paragrafo alla fine dell'intervallo di testo. Il paragrafo mantiene lo stile del alla fine dell'intervallo di testo corrente.

La stringa di testo fornita viene aggiunta come paragrafo aggiungendo almeno uno circostante una nuova riga alla stringa.

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

Parametri

NomeTipoDescrizione
textStringLa stringa da aggiungere come paragrafo.

Invio

Paragraph: 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)

Aggiunge 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.

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)

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

Se impostato in modo da corrispondere alla formattazione del testo di destinazione, AutoText all'interno dell'intervallo vengono sostituiti dai valori visualizzati. Inoltre, tutti gli elementi non testuali all'interno l'intervallo di testo fornito non viene aggiunto.

Parametri

NomeTipoDescrizione
textRangeTextRangeL'intervallo di testo da aggiungere.
matchSourceFormattingBooleanSe true, corrisponde alla formattazione del testo di origine. se false, corrisponde alla 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 il testo alla fine dell'intervallo di testo. Il testo mantiene lo stile della fine del testo esistente.

Parametri

NomeTipoDescrizione
textStringLa stringa da aggiungere.

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 limitato da questo intervallo della forma o cella di tabella associata in una appropriato da mostrare agli utenti finali.

Gli elementi di testo automatico, ad esempio i numeri delle slide generati, vengono sostituiti con i valori visualizzati. Tutti gli elementi non testuali 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 limitato da questo intervallo della forma o della cella di tabella associata.

Gli elementi di testo automatico, come i numeri delle slide generati ed eventuali elementi non testuali nell'intervallo, vengono sostituito 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 limitato da questo intervallo.

Dato che l'intero testo in una forma o in una TableCell deve terminare con una nuova riga, la nuova riga finale il testo non venga 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 di inizio e fine nell'intervallo.

Poiché il testo deve terminare con una nuova riga, la nuova riga finale non viene rimossa, anche se coperta dagli compensazioni date.

Parametri

NomeTipoDescrizione
startOffsetIntegerIl numero di caratteri che superano 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. startOffset deve inoltre essere inferiore alla lunghezza dell'intervallo corrente.
endOffsetIntegerIl numero di caratteri che superano l'indice iniziale dell'intervallo di testo corrente utilizzato per determinare l'indice finale esclusivo dell'intervallo da cancellare. Il endOffset deve essere uguale o superiore a startOffset. endOffset deve anche essere inferiore a 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 che corrispondono al pattern di ricerca nell'intervallo di testo corrente. La ricerca sensibile alle maiuscole.

Parametri

NomeTipoDescrizione
patternStringIl pattern dell'espressione regolare da cercare; eventuali barre rovesciate nel pattern caratteri di escape.

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

Parametri

NomeTipoDescrizione
patternStringIl pattern dell'espressione regolare da cercare; eventuali barre rovesciate nel pattern caratteri di escape.
startOffsetIntegerIl numero di caratteri che superano l'indice iniziale dell'intervallo di testo corrente utilizzato per determinare l'indice iniziale inclusivo dell'intervallo da cercare. startOffset deve essere 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 in base 0 per l'ultimo carattere in questo intervallo. Se l'inizio e la fine indici 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 che corrispondono a tutti i valori Link all'interno dell'intervallo a un intervallo di testo o che si sovrappongono all'intervallo di testo corrente.

Ogni intervallo restituito copre un solo link al momento della creazione. Modifiche del testo può 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

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 negli 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 valore 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 valore 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 valore TextRange che copre parte dell'intervallo da cui deriva.

Parametri

NomeTipoDescrizione
startOffsetIntegerIl numero di caratteri che superano 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. startOffset deve inoltre essere inferiore alla lunghezza dell'intervallo corrente.
endOffsetIntegerIl numero di caratteri che superano l'indice iniziale dell'intervallo di testo corrente utilizzato per determinare l'indice finale esclusivo dell'intervallo restituito. Il endOffset deve essere uguale o superiore a startOffset. endOffset deve anche essere inferiore a 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 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.

Ogni intervallo restituito è garantito solo per un'esecuzione al momento della creazione. Testo o stile modifiche può far sì che non rappresenti più esattamente un'esecuzione.

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 in base 0 per il primo carattere di questo intervallo. Se l'inizio gli indici finali 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 di 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 all'offset iniziale. Il paragrafo mantiene lo stile dello stile intervallo di testo all'offset iniziale.

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

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

Parametri

NomeTipoDescrizione
startOffsetIntegerIl numero di caratteri che superano 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 valore 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 all'offset iniziale.

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

Parametri

NomeTipoDescrizione
startOffsetIntegerIl numero di caratteri che superano 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 all'offset iniziale.

Se impostato in modo da corrispondere alla formattazione del testo di destinazione, AutoText all'interno dell'intervallo vengono sostituiti dai valori visualizzati. Inoltre, tutti gli elementi non testuali all'interno l'intervallo di testo fornito non viene inserito.

Parametri

NomeTipoDescrizione
startOffsetIntegerIl numero di caratteri che superano 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, corrisponde alla formattazione del testo di origine. se false, corrisponde alla 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 all'offset iniziale. Il testo mantiene lo stile del testo esistente nei all'offset iniziale.

Parametri

NomeTipoDescrizione
startOffsetIntegerIl numero di caratteri che superano 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 ci sono caratteri in questo intervallo e restituisce false negli altri casi.

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 a Trova testo con Sostituisci testo. La ricerca è maiuscola insensibile.

Parametri

NomeTipoDescrizione
findTextStringIl testo da trovare.
replaceTextStringIl testo per sostituire il testo corrispondente.

Invio

Integer: il numero di occorrenze modificato

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 a Trova testo con Sostituisci testo.

Parametri

NomeTipoDescrizione
findTextStringIl testo da trovare.
replaceTextStringIl testo per sostituire il testo corrispondente.
matchCaseBooleanSe true, la ricerca è sensibile alle maiuscole. se false, la ricerca viene senza distinzione tra maiuscole e minuscole.

Invio

Integer: il numero di occorrenze modificato

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 il TextRange nella presentazione attiva e rimuove gli eventuali selezione.

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

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

    Selection può essere di due tipi:
    • 1. Intervallo di testo, utilizza select su un TextRange non vuoto per selezionare l'intervallo di caratteri.
    • 2. Posizione del cursore: utilizza un 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 delimitato da questo intervallo della forma o della cella di 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