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
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
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
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
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
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()
getParagraphStyle()
Restituisce il valore ParagraphStyle
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
getParagraphs()
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
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
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
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
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.
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
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