Un segmento dei contenuti di testo di un Shape
o di un Table
.
Se utilizzi metodi che modificano l'adattamento del testo all'interno di una forma, le impostazioni di adattamento automatico applicate alla forma vengono disattivate.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
append | Paragraph | Aggiunge un paragrafo alla fine dell'intervallo di testo. |
append | Text | Aggiunge una copia dell'intervallo di testo fornito alla fine dell'intervallo di testo corrente. |
append | Text | Aggiunge una copia dell'intervallo di testo fornito alla fine dell'intervallo di testo corrente. |
append | Text | Aggiunge testo alla fine dell'intervallo di testo. |
as | String | Restituisce il testo sottoposto a rendering delimitato da questo intervallo della forma o della cella di tabella associata in un formato appropriato per la visualizzazione agli utenti finali. |
as | String | Restituisce il testo non formattato delimitato da questo intervallo della forma o della cella di tabella associata. |
clear() | void | Cancella il testo delimitato da questo intervallo. |
clear(startOffset, endOffset) | void | Cancella il testo delimitato dagli offset iniziale e finale nell'intervallo. |
find(pattern) | Text | Restituisce tutti gli intervalli corrispondenti al pattern di ricerca nell'intervallo di testo corrente. |
find(pattern, startOffset) | Text | Restituisce tutti gli intervalli corrispondenti al pattern di ricerca nell'intervallo di testo corrente a partire dall'offset iniziale. |
get | Auto | Restituisce i testi automatici all'interno dell'intervallo di testo corrente. |
get | Integer | Restituisce l'indice esclusivo a base 0 dell'ultimo carattere di questo intervallo. |
get | Integer | Restituisce il numero di caratteri in questo intervallo. |
get | Text | Restituisce una raccolta di intervalli di testo che corrispondono a tutti i Link all'interno dell'intervallo di testo corrente o che si sovrappongono all'intervallo di testo corrente. |
get | Paragraph[] | Restituisce i paragrafi negli elenchi che si sovrappongono all'intervallo di testo corrente. |
get | List | Restituisce il List dell'intervallo di testo corrente. |
get | Paragraph | Restituisce il Paragraph dell'intervallo di testo corrente. |
get | Paragraph[] | Restituisce i paragrafi che si sovrappongono all'intervallo di testo corrente. |
get | Text | Restituisce una nuova Text che copre parte dell'intervallo da cui viene derivata. |
get | Text | Restituisce le sequenze di testo che si sovrappongono all'intervallo di testo corrente. |
get | Integer | Restituisce l'indice inclusivo a base 0 del primo carattere di questo intervallo. |
get | Text | Restituisce lo stile del testo dell'intervallo o null se l'intervallo è vuoto. |
insert | Paragraph | Inserisce un paragrafo all'offset iniziale. |
insert | Text | Inserisce una copia dell'intervallo di testo fornito all'offset iniziale. |
insert | Text | Inserisce una copia dell'intervallo di testo fornito all'offset iniziale. |
insert | Text | Inserisce il testo all'offset iniziale. |
is | Boolean | Restituisce true se non sono presenti caratteri in questo intervallo, altrimenti restituisce false . |
replace | Integer | Sostituisce tutte le istanze di testo corrispondenti al testo di ricerca con il testo sostitutivo. |
replace | Integer | Sostituisce tutte le istanze di testo corrispondenti al testo di ricerca con il testo sostitutivo. |
select() | void | Seleziona solo Text nella presentazione attiva e rimuove qualsiasi selezione precedente. |
set | Text | Imposta il testo delimitato da questo intervallo della forma o della cella di tabella associata. |
Documentazione dettagliata
append Paragraph(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 alla stringa.
Quando la stringa di testo fornita contiene caratteri di nuova riga (quindi è composta da più paragrafi), viene restituito l'ultimo paragrafo aggiunto.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | String | La stringa da aggiungere come paragrafo. |
Indietro
Paragraph
— The appended 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
append Range(textRange)
Aggiunge una copia dell'intervallo di testo fornito alla fine dell'intervallo di testo corrente.
La formattazione del testo inserito corrisponde a quella del testo di origine.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | Text | L'intervallo di testo da accodare. |
Indietro
Text
: 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
append Range(textRange, matchSourceFormatting)
Aggiunge 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, Auto
all'interno dell'intervallo di testo fornito vengono sostituiti con i relativi valori di rendering. Inoltre, gli elementi non di testo all'interno
dell'intervallo di testo fornito non vengono aggiunti.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | Text | L'intervallo di testo da accodare. |
match | Boolean | Se true , corrisponde alla formattazione del testo di origine; se
false , corrisponde alla formattazione del testo di destinazione. |
Indietro
Text
: 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
append Text(text)
Aggiunge 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. |
Indietro
Text
: 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
as Rendered String()
Restituisce il testo sottoposto a rendering delimitato da questo intervallo della forma o della cella di tabella associata in un formato appropriato per la visualizzazione agli utenti finali.
Gli elementi di testo automatici
Indietro
String
: il testo sottoposto a rendering nell'intervallo.
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
as String()
Restituisce il testo non formattato delimitato da questo intervallo della forma o della cella di tabella associata.
Gli elementi di testo come i numeri di slide generati e gli elementi non di testo nell'intervallo vengono sostituiti con il carattere Unicode U+E907.
Indietro
String
: il testo non formattato nell'intervallo.
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 in una cella di tabella deve terminare con un carattere di nuova riga, l'ultimo carattere di nuova riga 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 carattere di nuova riga, l'ultimo carattere di nuova riga nel testo non viene rimosso anche se è coperto dagli offset specificati.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
start | Integer | Il 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
maggiore o uguale a 0 e minore o uguale a end . start
deve essere inferiore alla lunghezza dell'intervallo corrente. |
end | Integer | Il numero di caratteri oltre l'indice iniziale dell'intervallo di testo corrente utilizzato
per determinare l'indice finale esclusivo dell'intervallo da cancellare. end deve essere
maggiore o uguale a start . end deve essere anche inferiore o
uguale alla lunghezza dell'intervallo corrente. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
find(pattern)
Restituisce tutti gli intervalli corrispondenti al pattern di ricerca nell'intervallo di testo corrente. La ricerca è sensibile alle maiuscole.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
pattern | String | Il pattern di espressione regolare da cercare; tutte le barre rovesciate nel pattern devono essere sottoposte a escape. |
Indietro
Text
: un elenco di intervalli di testo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
find(pattern, startOffset)
Restituisce tutti gli intervalli corrispondenti al pattern di ricerca nell'intervallo di testo corrente a partire dall'offset iniziale. La ricerca è sensibile alle maiuscole.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
pattern | String | Il pattern di espressione regolare da cercare; tutte le barre rovesciate nel pattern devono essere sottoposte a escape. |
start | Integer | Il numero di caratteri oltre l'indice iniziale dell'intervallo di testo corrente utilizzato
per determinare l'indice iniziale inclusivo dell'intervallo da cercare. start deve
anche essere inferiore alla lunghezza dell'intervallo corrente. |
Indietro
Text
: un elenco di intervalli di testo.
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
get Auto Texts()
Restituisce i testi automatici all'interno dell'intervallo di testo corrente.
Indietro
Auto
: un elenco di testi automatici.
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
get End Index()
Restituisce l'indice esclusivo a base 0 dell'ultimo carattere di questo intervallo. Se gli indici di inizio e fine sono uguali, l'intervallo viene considerato vuoto.
Indietro
Integer
: l'indice finale dell'intervallo.
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
get Length()
Restituisce il numero di caratteri in questo intervallo.
Indietro
Integer
: il numero di caratteri in questo intervallo.
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
get Links()
Restituisce una raccolta di intervalli di testo che corrispondono a tutti i Link
all'interno dell'intervallo di testo corrente o che si sovrappongono all'intervallo di testo corrente.
Ogni intervallo restituito ha la garanzia di coprire 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 Text
.
// 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
Indietro
Text
: un elenco di intervalli di testo.
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
get List Paragraphs()
Restituisce i paragrafi negli elenchi che si sovrappongono all'intervallo di testo corrente.
Indietro
Paragraph[]
: un elenco di paragrafi negli elenchi.
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
get List Style()
Restituisce il List
dell'intervallo di testo corrente.
Indietro
List
: lo stile elenco dell'intervallo di testo 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
get Paragraph Style()
Restituisce il Paragraph
dell'intervallo di testo corrente.
Indietro
Paragraph
: lo stile del paragrafo dell'intervallo di testo 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
get Paragraphs()
Restituisce i paragrafi che si sovrappongono all'intervallo di testo corrente.
Indietro
Paragraph[]
: un elenco di paragrafi.
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
get Range(startOffset, endOffset)
Restituisce una nuova Text
che copre parte dell'intervallo da cui viene derivata.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
start | Integer | Il 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
maggiore o uguale a 0 e minore o uguale a end . start
deve essere inferiore alla lunghezza dell'intervallo corrente. |
end | Integer | Il numero di caratteri oltre l'indice iniziale dell'intervallo di testo corrente utilizzato
per determinare l'indice finale esclusivo dell'intervallo restituito. end deve essere
maggiore o uguale a start . end deve essere anche inferiore o
uguale alla lunghezza dell'intervallo corrente. |
Indietro
Text
: un nuovo intervallo di testo.
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
get Runs()
Restituisce le sequenze di testo che si sovrappongono all'intervallo di testo corrente. Un segmento di testo è un segmento di testo in cui tutti i caratteri hanno lo stesso stile di testo.
Ogni intervallo restituito è garantito per coprire una sola esecuzione al momento della creazione. Modifiche al testo o allo stile possono far sì che non rappresenti più esattamente una corsa.
Indietro
Text
: un elenco di intervalli di testo.
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
get Start Index()
Restituisce l'indice inclusivo a base 0 del primo carattere di questo intervallo. Se gli indici iniziale e finale sono uguali, l'intervallo viene considerato vuoto.
Indietro
Integer
: l'indice iniziale dell'intervallo.
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
get Text Style()
Restituisce lo stile del testo dell'intervallo o null
se l'intervallo è vuoto.
Indietro
Text
: lo stile del testo dell'intervallo.
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
insert Paragraph(startOffset, text)
Inserisce un paragrafo all'offset iniziale. Il paragrafo mantiene lo stile dell'intervallo di testo corrente all'offset iniziale.
La stringa di testo fornita viene inserita come paragrafo aggiungendo almeno un carattere di nuova riga alla stringa.
Quando la stringa di testo fornita contiene caratteri di nuova riga (quindi è composta da più paragrafi), viene restituito l'ultimo paragrafo aggiunto.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
start | Integer | Il numero di caratteri dopo 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. |
Indietro
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
insert Range(startOffset, textRange)
Inserisce una copia dell'intervallo di testo fornito all'offset iniziale.
La formattazione del testo inserito corrisponde a quella del testo di origine.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
start | Integer | Il numero di caratteri dopo l'indice iniziale dell'intervallo di testo corrente utilizzato per determinare l'indice iniziale inclusivo del testo da inserire. |
text | Text | L'intervallo di testo da inserire. |
Indietro
Text
: 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
insert Range(startOffset, textRange, matchSourceFormatting)
Inserisce una copia dell'intervallo di testo fornito all'offset iniziale.
Se è impostato in modo che corrisponda alla formattazione del testo di destinazione, Auto
all'interno dell'intervallo di testo fornito vengono sostituiti con i relativi valori di rendering. Inoltre, non vengono inseriti elementi non di testo
all'interno dell'intervallo di testo fornito.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
start | Integer | Il numero di caratteri dopo l'indice iniziale dell'intervallo di testo corrente utilizzato per determinare l'indice iniziale inclusivo del testo da inserire. |
text | Text | L'intervallo di testo da inserire. |
match | Boolean | Se true , corrisponde alla formattazione del testo di origine; se
false , corrisponde alla formattazione del testo di destinazione. |
Indietro
Text
: 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
insert Text(startOffset, text)
Inserisce il testo all'offset iniziale. Il testo mantiene lo stile del testo esistente all'offset iniziale.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
start | Integer | Il numero di caratteri dopo 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. |
Indietro
Text
: 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
is Empty()
Restituisce true
se non sono presenti caratteri in questo intervallo, altrimenti restituisce false
.
Indietro
Boolean
— true
se non sono presenti caratteri in questo intervallo, altrimenti restituisce false
.
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
replace All Text(findText, replaceText)
Sostituisce tutte le istanze di testo corrispondenti al testo di ricerca con il testo sostitutivo. La ricerca non distingue tra maiuscole e minuscole.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
find | String | Il testo da trovare. |
replace | String | Il testo con cui sostituire il testo corrispondente. |
Indietro
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
replace All Text(findText, replaceText, matchCase)
Sostituisce tutte le istanze di testo corrispondenti al testo di ricerca con il testo sostitutivo.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
find | String | Il testo da trovare. |
replace | String | Il testo con cui sostituire il testo corrispondente. |
match | Boolean | Se true , la ricerca è sensibile alle maiuscole; se false , la ricerca non
distingue tra maiuscole e minuscole. |
Indietro
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 Text
nella presentazione attiva e rimuove qualsiasi selezione precedente.
Uno script può accedere solo alla selezione dell'utente che lo esegue e solo se lo script è associato alla presentazione.
L'elemento principale Page
del Shape
o del Table
corrispondente è impostato
come current page selection
. Shape
o Table
è impostato come selected page element
.
Selection
può essere di due tipi:
- 1. Intervallo di testo: utilizza la selezione su un TextRange 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
-
set Text(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 |
---|---|---|
new | String | La stringa da impostare come nuovo testo. |
Indietro
Text
: 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