Questa pagina è stata tradotta dall'API Cloud Translation.

Class 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

Metodo	Tipo restituito	Breve descrizione
`appendParagraph(text)`	`Paragraph`	Consente di aggiungere un paragrafo alla fine dell'intervallo di testo.
`appendRange(textRange)`	`TextRange`	Aggiunge una copia dell'intervallo di testo fornito alla fine dell'intervallo di testo corrente.
`appendRange(textRange, matchSourceFormatting)`	`TextRange`	Aggiunge una copia dell'intervallo di testo fornito alla fine dell'intervallo di testo corrente.
`appendText(text)`	`TextRange`	Aggiunge il testo alla fine dell'intervallo di testo.
`asRenderedString()`	`String`	Restituisce il testo visualizzato limitato da questo intervallo della forma o cella di tabella associata in una appropriato da mostrare agli utenti finali.
`asString()`	`String`	Restituisce il testo non elaborato limitato da questo intervallo della forma o della cella di tabella associata.
`clear()`	`void`	Cancella il testo limitato da questo intervallo.
`clear(startOffset, endOffset)`	`void`	Cancella 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()`	`Integer`	Restituisce l'indice esclusivo in base 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 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()`	`ListStyle`	Restituisce il valore `ListStyle` dell'intervallo di testo corrente.
`getParagraphStyle()`	`ParagraphStyle`	Restituisce il valore `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 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()`	`Integer`	Restituisce l'indice incluso in base 0 per il primo carattere di questo intervallo.
`getTextStyle()`	`TextStyle`	Restituisce lo stile di testo dell'intervallo o `null` se l'intervallo è vuoto.
`insertParagraph(startOffset, text)`	`Paragraph`	Inserisce un paragrafo all'offset iniziale.
`insertRange(startOffset, textRange)`	`TextRange`	Inserisce una copia dell'intervallo di testo fornito all'offset iniziale.
`insertRange(startOffset, textRange, matchSourceFormatting)`	`TextRange`	Inserisce una copia dell'intervallo di testo fornito all'offset iniziale.
`insertText(startOffset, text)`	`TextRange`	Inserisce il testo all'offset iniziale.
`isEmpty()`	`Boolean`	Restituisce `true` se non ci sono caratteri in questo intervallo e restituisce `false` negli altri casi.
`replaceAllText(findText, replaceText)`	`Integer`	Sostituisce tutte le istanze di testo corrispondenti a Trova testo con Sostituisci testo.
`replaceAllText(findText, replaceText, matchCase)`	`Integer`	Sostituisce tutte le istanze di testo corrispondenti a Trova testo con Sostituisci testo.
`select()`	`void`	Seleziona solo il `TextRange` nella presentazione attiva e rimuove gli eventuali selezione.
`setText(newText)`	`TextRange`	Imposta 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

Nome	Tipo	Descrizione
`text`	`String`	La 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

Nome	Tipo	Descrizione
`textRange`	`TextRange`	L'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

Nome	Tipo	Descrizione
`textRange`	`TextRange`	L'intervallo di testo da aggiungere.
`matchSourceFormatting`	`Boolean`	Se `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

Nome	Tipo	Descrizione
`text`	`String`	La 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

Nome	Tipo	Descrizione
`startOffset`	`Integer`	Il 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.
`endOffset`	`Integer`	Il 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

Nome	Tipo	Descrizione
`pattern`	`String`	Il 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

Nome	Tipo	Descrizione
`pattern`	`String`	Il pattern dell'espressione regolare da cercare; eventuali barre rovesciate nel pattern caratteri di escape.
`startOffset`	`Integer`	Il 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

`getLinks()`

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

Nome	Tipo	Descrizione
`startOffset`	`Integer`	Il 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.
`endOffset`	`Integer`	Il 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

Nome	Tipo	Descrizione
`startOffset`	`Integer`	Il numero di caratteri che superano 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 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

Nome	Tipo	Descrizione
`startOffset`	`Integer`	Il numero di caratteri che superano 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 all'offset iniziale.

Parametri

Nome	Tipo	Descrizione
`startOffset`	`Integer`	Il numero di caratteri che superano 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`, 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

Nome	Tipo	Descrizione
`startOffset`	`Integer`	Il numero di caratteri che superano 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 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

Nome	Tipo	Descrizione
`findText`	`String`	Il testo da trovare.
`replaceText`	`String`	Il 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

Nome	Tipo	Descrizione
`findText`	`String`	Il testo da trovare.
`replaceText`	`String`	Il testo per sostituire il testo corrispondente.
`matchCase`	`Boolean`	Se `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

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