Un segmento dei contenuti di testo di un Shape
o di un Table
.
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
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
append | Paragraph | Aggiunge un paragrafo alla fine dell'intervallo di testo. |
append | Text | Collega una copia dell'intervallo di testo specificato alla fine dell'intervallo di testo corrente. |
append | Text | Collega una copia dell'intervallo di testo specificato alla fine dell'intervallo di testo corrente. |
append | Text | Aggiunge del testo alla fine dell'intervallo di testo. |
as | String | Restituisce il testo visualizzato delimitato da questo intervallo della forma o della cella della tabella associata in un formato appropriato per la visualizzazione agli utenti finali. |
as | String | Restituisce il testo non elaborato delimitato da questo intervallo della forma o della cella della 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 partire da 0 per l'ultimo carattere in questo intervallo. |
get | Integer | Restituisce il numero di caratteri in questo intervallo. |
get | Text | Restituisce una raccolta di intervalli di testo corrispondenti a tutti i Link all'interno dell'intervallo di testo corrente o che si sovrappongono all'intervallo di testo corrente. |
get | Paragraph[] | Restituisce i paragrafi degli 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 un nuovo Text che copre parte dell'intervallo da cui è dedotto. |
get | Text | Restituisce le righe di testo che si sovrappongono all'intervallo di testo corrente. |
get | Integer | Restituisce l'indice incluso a partire da 0 per il 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 nell'offset di inizio. |
insert | Text | Inserisce una copia dell'intervallo di testo fornito nell'offset iniziale. |
insert | Text | Inserisce una copia dell'intervallo di testo fornito nell'offset iniziale. |
insert | Text | Inserisce il testo nell'offset iniziale. |
is | Boolean | Restituisce true se non sono presenti caratteri in questo intervallo e false
altrimenti. |
replace | Integer | Sostituisce tutte le istanze di testo corrispondenti al testo trovato con il testo sostitutivo. |
replace | Integer | Sostituisce tutte le istanze di testo corrispondenti al testo trovato con il testo sostitutivo. |
select() | void | Consente di selezionare solo il Text nella presentazione attiva e di rimuovere qualsiasi selezione precedente. |
set | Text | Imposta il testo delimitato da questo intervallo della forma o della cella della 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 alla stringa almeno un carattere di riga nuova.
Quando la stringa di testo fornita contiene caratteri di nuova riga (quindi è composta da più paragrafi), viene restituito il paragrafo finale aggiunto.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | String | La stringa da aggiungere come paragrafo. |
Invio
Paragraph
: il valore Paragraph
aggiunto.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
append Range(textRange)
Collega una copia dell'intervallo di testo specificato alla fine dell'intervallo di testo corrente.
La formattazione del testo inserito corrisponderà a quella del testo di origine.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | Text | L'intervallo di testo da accodare. |
Invio
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)
Collega una copia dell'intervallo di testo specificato alla fine dell'intervallo di testo corrente.
Se impostato in modo da corrispondere alla formattazione del testo di destinazione, i Auto
all'interno dell'intervallo di testo fornito vengono sostituiti con i relativi valori visualizzati. Inoltre, eventuali elementi non di testo all'interno
dell'intervallo di testo specificato non vengono aggiunti.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | Text | L'intervallo di testo da accodare. |
match | Boolean | Se true , applica la formattazione del testo di origine; se
false , applica la formattazione del testo di destinazione. |
Invio
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 del 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 accodare. |
Invio
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 visualizzato delimitato da questo intervallo della forma o della cella della tabella associata in un formato appropriato per la visualizzazione agli utenti finali.
Gli elementi di testo automatico
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
as String()
Restituisce il testo non elaborato delimitato da questo intervallo della forma o della cella della tabella associata.
Invio
String
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
clear()
Cancella il testo delimitato da questo intervallo.
Poiché l'intero testo in una forma o una cella della tabella deve terminare con un a capo, l'a capo finale nel testo non viene rimosso.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
clear(startOffset, endOffset)
Cancella il testo delimitato dagli offset iniziale e finale nell'intervallo.
Poiché il testo deve terminare con un a capo, l'a capo finale nel testo non viene rimosso anche se è coperto dagli offset specificati.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
start | Integer | Il numero di caratteri oltre l'indice iniziale dell'intervallo di testo corrente utilizzato
per determinare l'indice iniziale dell'intervallo da cancellare. L'offset iniziale deve essere uguale o maggiore di 0 e minore o uguale a end . start
deve essere inferiore anche 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
uguale o maggiore di start . end deve inoltre essere inferiore o uguale alla lunghezza dell'intervallo corrente. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
find(pattern)
Restituisce tutti gli intervalli corrispondenti al pattern di ricerca nell'intervallo di testo corrente. La ricerca è sensibile alle maiuscole.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
pattern | String | Il pattern di espressione regolare da cercare. Eventuali barre di sbarramento nel pattern devono essere sfuggite. |
Invio
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. Eventuali barre di sbarramento nel pattern devono essere sfuggite. |
start | Integer | Il numero di caratteri oltre l'indice iniziale dell'intervallo di testo corrente utilizzato per determinare l'indice iniziale incluso dell'intervallo da cercare. start deve essere anche inferiore alla lunghezza dell'intervallo corrente. |
Invio
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.
Invio
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 partire da 0 per l'ultimo carattere in questo intervallo. Se gli indici di inizio e di fine sono uguali, l'intervallo è considerato vuoto.
Invio
Integer
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Length()
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
get Links()
Restituisce una raccolta di intervalli di testo corrispondenti a tutti i Link
all'interno dell'intervallo di testo corrente o che si sovrappongono all'intervallo di testo corrente.
È garantito che ogni intervallo restituito si estenda su un link al momento della creazione. Le modifiche al testo possono fare in modo che non rappresenti più esattamente un link.
È possibile accedere a ogni Link
negli intervalli restituiti tramite 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
Invio
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 degli elenchi che si sovrappongono all'intervallo di testo corrente.
Invio
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()
get Paragraph Style()
Restituisce il Paragraph
dell'intervallo di testo corrente.
Invio
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.
Invio
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 un nuovo Text
che copre parte dell'intervallo da cui è dedotto.
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 dell'intervallo restituito. L'offset iniziale deve essere uguale o maggiore di 0 e minore o uguale a end . start
deve essere inferiore anche 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
uguale o maggiore di start . end deve inoltre essere inferiore o uguale alla lunghezza dell'intervallo corrente. |
Invio
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 righe di testo che si sovrappongono all'intervallo di testo corrente. Una corsa di testo è un segmento di testo in cui tutti i caratteri hanno lo stesso stile di testo.
È garantito che ogni intervallo restituito si estenda a una sola esecuzione al momento della creazione. Le modifiche al testo o allo stile possono causare la mancata rappresentazione di esattamente una corsa.
Invio
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 incluso a partire da 0 per il primo carattere di questo intervallo. Se gli indici iniziale e finale sono uguali, l'intervallo è considerato vuoto.
Invio
Integer
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Text Style()
Restituisce lo stile del testo dell'intervallo o null
se l'intervallo è vuoto.
Invio
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 nell'offset di inizio. Il paragrafo mantiene lo stile dell'intervallo di testo corrente nell'offset iniziale.
La stringa di testo fornita viene inserita come paragrafo aggiungendo alla stringa almeno un carattere di riga nuova.
Quando la stringa di testo fornita contiene caratteri di nuova riga (quindi è composta da più paragrafi), viene restituito il paragrafo finale aggiunto.
Parametri
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 del testo da inserire. |
text | String | La stringa da inserire. |
Invio
Paragraph
: il Paragraph
inserito.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Range(startOffset, textRange)
Inserisce una copia dell'intervallo di testo fornito nell'offset iniziale.
La formattazione del testo inserito corrisponderà a quella del testo di origine.
Parametri
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 del testo da inserire. |
text | Text | L'intervallo di testo da inserire. |
Invio
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 nell'offset iniziale.
Se impostato in modo da corrispondere alla formattazione del testo di destinazione, i Auto
all'interno dell'intervallo di testo fornito vengono sostituiti con i relativi valori visualizzati. Inoltre, eventuali elementi non di testo all'interno
dell'intervallo di testo specificato non vengono inseriti.
Parametri
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 del testo da inserire. |
text | Text | L'intervallo di testo da inserire. |
match | Boolean | Se true , applica la formattazione del testo di origine; se
false , applica la formattazione del testo di destinazione. |
Invio
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 nell'offset iniziale. Il testo mantiene lo stile del testo esistente all'offset iniziale.
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 del testo da inserire. |
text | String | La stringa da inserire. |
Invio
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 e false
altrimenti.
Invio
Boolean
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace All Text(findText, replaceText)
Sostituisce tutte le istanze di testo corrispondenti al testo trovato con il testo sostitutivo. La ricerca non fa distinzione tra maiuscole e minuscole.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
find | String | Il testo da trovare. |
replace | String | Il testo da sostituire al testo corrispondente. |
Invio
Integer
: il numero di occorrenze modificate
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace All Text(findText, replaceText, matchCase)
Sostituisce tutte le istanze di testo corrispondenti al testo trovato con il testo sostitutivo.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
find | String | Il testo da trovare. |
replace | String | Il testo da sostituire al testo corrispondente. |
match | Boolean | Se true , la ricerca è sensibile alle maiuscole; se false , la ricerca è
insensibile alle maiuscole. |
Invio
Integer
: il numero di occorrenze modificate
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select()
Consente di selezionare solo il Text
nella presentazione attiva e di rimuovere qualsiasi selezione precedente.
Uno script può accedere alla selezione dell'utente che lo esegue solo se è legato alla presentazione.
Il Page
principale del Shape
o del 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 seleziona su un intervallo di testo non vuoto per selezionare l'intervallo di caratteri.
- 2. Posizione del cursore: utilizza un TextRange vuoto per posizionare il cursore nell'indice desiderato.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; shape.getText().setText('Hello'); // Range selection: Select the text range "He". shape.getText().getRange(0, 2).select(); // Cursor selection: Place the cursor after "H" like "H|ello". shape.getText().getRange(1, 1).select();
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
-
set Text(newText)
Imposta il testo delimitato da questo intervallo della forma o della cella della tabella associata. Il testo mantiene lo stile dell'inizio del testo esistente.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
new | String | La stringa da impostare come nuovo testo. |
Invio
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