Lo stile del testo.
I metodi di lettura in questa classe restituiscono null se l'elemento Text corrispondente si estende
su più esecuzioni di testo e queste esecuzioni hanno valori diversi per il metodo di lettura chiamato. Per
evitare questo problema, esegui query per gli stili di testo utilizzando Text restituiti dal metodo Text.
Se utilizzi metodi che modificano l'adattamento del testo all'interno di una forma, tutte le impostazioni di adattamento automatico applicate agli stili di testo vengono disattivate.
Metodi
| Metodo | Tipo restituito | Breve descrizione |
|---|---|---|
get | Color|null | Restituisce il colore di sfondo del testo o null se il testo ha più stili. |
get | Text | Restituisce l'offset verticale del testo dalla sua posizione normale o null se il testo ha più stili. |
get | String|null | Restituisce la famiglia di caratteri del testo o null se il testo ha più stili. |
get | Number|null | Restituisce le dimensioni del carattere del testo in punti o null se il testo presenta più stili. |
get | Integer|null | Restituisce lo spessore del carattere del testo o null se il testo ha più stili. |
get | Color|null | Restituisce il colore del testo in primo piano o null se il testo ha più stili. |
get | Link|null | Restituisce il Link sul testo oppure null se non è presente alcun link o se il link si trova su
parte del testo o se sono presenti più link. |
has | Boolean|null | Restituisce true se il testo contiene un link, false in caso contrario o null se il
link si trova in una parte del testo o se sono presenti più link. |
is | Boolean|null | Restituisce true se lo sfondo del testo è trasparente, false in caso contrario o
null se il testo ha più stili. |
is | Boolean|null | Restituisce true se il testo viene visualizzato in grassetto, false in caso contrario o null se
il testo presenta più stili. |
is | Boolean|null | Restituisce true se il testo è in corsivo, false in caso contrario o null se
il testo ha più stili. |
is | Boolean|null | Restituisce true se il testo è in piccole maiuscole, false in caso contrario o null se il testo ha più stili. |
is | Boolean|null | Restituisce true se il testo è barrato, false in caso contrario o null se
il testo ha più stili. |
is | Boolean|null | Restituisce true se il testo è sottolineato, false in caso contrario o null se
il testo ha più stili. |
remove | Text | Rimuove un Link. |
set | Text | Imposta il colore di sfondo del testo. |
set | Text | Imposta il colore di sfondo del testo sui valori RGB specificati da 0 a 255. |
set | Text | Imposta il colore di sfondo del testo sulla stringa di colore esadecimale specificata. |
set | Text | Imposta il colore di sfondo del testo sul Theme specificato. |
set | Text | Imposta il colore di sfondo del testo su trasparente. |
set | Text | Imposta l'offset verticale del testo rispetto alla sua posizione normale. |
set | Text | Imposta se il testo deve essere visualizzato in grassetto. |
set | Text | Imposta la famiglia di caratteri del testo . |
set | Text | Imposta la famiglia e il peso del carattere del testo. |
set | Text | Imposta la dimensione del carattere del testo, in punti. |
set | Text | Imposta il colore di primo piano del testo. |
set | Text | Imposta il colore del testo in primo piano sui valori RGB specificati da 0 a 255. |
set | Text | Imposta il colore di primo piano del testo sulla stringa di colore esadecimale specificata. |
set | Text | Imposta il colore del testo in primo piano sul valore Theme specificato. |
set | Text | Imposta se il testo è in corsivo. |
set | Text | Imposta un Link sul Slide specificato utilizzando l'indice della slide basato su zero. |
set | Text | Imposta un Link sul Slide specificato. Il link viene impostato in base all'ID slide specificato. |
set | Text | Imposta un Link sul Slide specificato utilizzando la posizione relativa della slide. |
set | Text | Imposta un Link sulla stringa URL non vuota specificata. |
set | Text | Specifica se il testo viene visualizzato in piccole lettere maiuscole. |
set | Text | Imposta se il testo è barrato. |
set | Text | Imposta se il testo è sottolineato. |
Documentazione dettagliata
get Background Color()
Restituisce il colore di sfondo del testo o null se il testo ha più stili.
Indietro
Color|null: il colore di sfondo del 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 Baseline Offset()
Restituisce l'offset verticale del testo dalla sua posizione normale o null se il testo ha più stili.
Indietro
Text: lo scostamento verticale del testo dalla sua posizione normale.
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 Font Family()
Restituisce la famiglia di caratteri del testo o null se il testo ha più stili.
Indietro
String|null: la famiglia di caratteri del 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 Font Size()
Restituisce le dimensioni del carattere del testo in punti o null se il testo presenta più stili.
Indietro
Number|null: le dimensioni del carattere del testo in punti.
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 Font Weight()
Restituisce lo spessore del carattere del testo o null se il testo ha più stili.
Il peso è un multiplo di 100 compreso tra 100 e 900 inclusi. Questo intervallo corrisponde ai valori numerici descritti nella specifica CSS 2.1, sezione 15.6, con valori non numerici non consentiti. I pesi maggiori o uguali a 700 sono considerati in grassetto, nel qual caso is restituisce true. Il valore predefinito è 400 ("normale").
Indietro
Integer|null: lo spessore del carattere del 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 Foreground Color()
Restituisce il colore del testo in primo piano o null se il testo ha più stili.
Indietro
Color|null: il colore di primo piano del 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 Link()
Restituisce il Link sul testo oppure null se non è presente alcun link o se il link si trova su
parte del testo o se sono presenti più link. Chiama has per determinare se
il testo non contiene link.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; const textLink = shape.getText().getTextStyle().getLink(); if (textLink != null) { Logger.log(`Shape text has a link of type: ${textLink.getLinkType()}`); }
Indietro
Link|null: il link nel 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
has Link()
Restituisce true se il testo contiene un link, false in caso contrario o null se il
link si trova in una parte del testo o se sono presenti più link.
I link non possono essere impostati su caratteri di nuova riga. Pertanto, se Text contiene un
carattere di nuova riga, questo metodo restituisce sempre null o false.
Indietro
Boolean|null: indica se è presente un link nel 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
is Background Transparent()
Restituisce true se lo sfondo del testo è trasparente, false in caso contrario o
null se il testo ha più stili.
Indietro
Boolean|null: indica se lo sfondo del testo è trasparente.
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 Bold()
Restituisce true se il testo viene visualizzato in grassetto, false in caso contrario o null se
il testo presenta più stili.
Indietro
Boolean|null: indica se il testo viene visualizzato in grassetto.
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 Italic()
Restituisce true se il testo è in corsivo, false in caso contrario o null se
il testo ha più stili.
Indietro
Boolean|null: indica se il testo è in corsivo.
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 Small Caps()
Restituisce true se il testo è in piccole maiuscole, false in caso contrario o null se il testo ha più stili.
Indietro
Boolean|null: indica se il testo è in maiuscoletto.
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 Strikethrough()
Restituisce true se il testo è barrato, false in caso contrario o null se
il testo ha più stili.
Indietro
Boolean|null: indica se il testo è barrato.
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 Underline()
Restituisce true se il testo è sottolineato, false in caso contrario o null se
il testo ha più stili.
Indietro
Boolean|null: indica se il testo è sottolineato.
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
remove Link()
Rimuove un Link.
La rimozione di un link comporta la rimozione del colore di primo piano e dello stile di sottolineatura del testo. Se possibile, questi stili vengono applicati in modo che corrispondano al testo che precede il link.
const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText(); textRange.getTextStyle().removeLink();
Indietro
set Background Color(color)
Imposta il colore di sfondo del testo.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
color | Color | Il colore di sfondo da impostare. |
Indietro
Text: questo Text, per il concatenamento.
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 Background Color(red, green, blue)
Imposta il colore di sfondo del testo sui valori RGB specificati da 0 a 255.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
red | Integer | Il componente rosso del colore. |
green | Integer | Il componente verde del colore. |
blue | Integer | Il componente blu del colore. |
Indietro
Text: questo Text, per il concatenamento.
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 Background Color(hexColor)
Imposta il colore di sfondo del testo sulla stringa di colore esadecimale specificata.
La stringa esadecimale deve essere nel formato "#RRGGBB". Ad esempio, il rosa è rappresentato come
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
hex | String | La stringa del colore esadecimale. |
Indietro
Text: questo Text, per il concatenamento.
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 Background Color(color)
Imposta il colore di sfondo del testo sul Theme specificato.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
color | Theme | Il tipo di colore del tema. |
Indietro
Text: questo Text, per il concatenamento.
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 Background Color Transparent()
Imposta il colore di sfondo del testo su trasparente.
Indietro
Text: questo Text, per il concatenamento.
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 Baseline Offset(offset)
Imposta l'offset verticale del testo rispetto alla sua posizione normale.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
offset | Text | L'offset di riferimento da impostare. |
Indietro
Text: questo Text, per il concatenamento.
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 Bold(bold)
Imposta se il testo deve essere visualizzato in grassetto.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
bold | Boolean | Indica se il testo deve essere visualizzato in grassetto. |
Indietro
Text: questo Text, per il concatenamento.
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 Font Family(fontFamily)
Imposta la famiglia di caratteri del testo .
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
font | String | La famiglia di caratteri da impostare. |
Indietro
Text: questo Text, per il concatenamento.
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 Font Family And Weight(fontFamily, fontWeight)
Imposta la famiglia e il peso del carattere del testo.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
font | String | La famiglia di caratteri. |
font | Integer | Lo spessore del carattere. |
Indietro
Text: questo Text, per il concatenamento.
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 Font Size(fontSize)
Imposta la dimensione del carattere del testo, in punti.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
font | Number | Le dimensioni del carattere in punti. |
Indietro
Text: questo Text, per il concatenamento.
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 Foreground Color(foregroundColor)
Imposta il colore di primo piano del testo.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
foreground | Color | Il colore del primo piano da impostare. |
Indietro
Text: questo Text, per il concatenamento.
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 Foreground Color(red, green, blue)
Imposta il colore del testo in primo piano sui valori RGB specificati da 0 a 255.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
red | Integer | Il componente rosso del colore. |
green | Integer | Il componente verde del colore. |
blue | Integer | Il componente blu del colore. |
Indietro
Text: questo Text, per il concatenamento.
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 Foreground Color(hexColor)
Imposta il colore di primo piano del testo sulla stringa di colore esadecimale specificata.
La stringa esadecimale deve essere nel formato "#RRGGBB". Ad esempio, il rosa è rappresentato come
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
hex | String | La stringa del colore esadecimale. |
Indietro
Text: questo Text, per il concatenamento.
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 Foreground Color(color)
Imposta il colore del testo in primo piano sul valore Theme specificato.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
color | Theme | Il tipo di colore del tema. |
Indietro
Text: questo Text, per il concatenamento.
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 Italic(italic)
Imposta se il testo è in corsivo.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
italic | Boolean | Indica se eseguire il rendering del testo in corsivo. |
Indietro
Text: questo Text, per il concatenamento.
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 Link Slide(slideIndex)
Imposta un Link sul Slide specificato utilizzando l'indice della slide basato su zero.
L'impostazione di un link modifica lo stile del testo in modo che sia sottolineato e abbia un colore di primo piano Theme. Puoi modificare questa opzione tramite set e set.
Poiché i link non possono essere impostati sui caratteri di nuova riga, questi ultimi in Text
vengono ignorati.
// Set a link to the first slide of the presentation. const presentation = SlidesApp.getActivePresentation(); const slide = presentation.getSlides()[0]; const textRange = slide.getShapes()[0].getText(); textRange.getTextStyle().setLinkSlide(0);
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
slide | Integer | L'indice in base zero della slide. |
Indietro
Text: questo Text, per il concatenamento.
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 Link Slide(slide)
Imposta un Link sul Slide specificato. Il link viene impostato in base all'ID slide specificato.
L'impostazione di un link modifica lo stile del testo in modo che sia sottolineato e abbia un colore di primo piano Theme. Puoi modificare questa opzione tramite set e set.
Poiché i link non possono essere impostati sui caratteri di nuova riga, questi ultimi in Text
vengono ignorati.
// Set a link to the first slide of the presentation. const presentation = SlidesApp.getActivePresentation(); const slide = presentation.getSlides()[0]; const textRange = slide.getShapes()[0].getText(); textRange.getTextStyle().setLinkSlide(slide);
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
slide | Slide | L'account Slide da collegare. |
Indietro
Text: questo Text, per il concatenamento.
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 Link Slide(slidePosition)
Imposta un Link sul Slide specificato utilizzando la posizione relativa della slide.
L'impostazione di un link modifica lo stile del testo in modo che sia sottolineato e abbia un colore di primo piano Theme. Puoi modificare questa opzione tramite set e set.
Poiché i link non possono essere impostati sui caratteri di nuova riga, questi ultimi in Text
vengono ignorati.
// Set a link to the first slide of the presentation. const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText(); textRange.getTextStyle().setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
slide | Slide | Il Slide relativo. |
Indietro
Text: questo Text, per il concatenamento.
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 Link Url(url)
Imposta un Link sulla stringa URL non vuota specificata.
L'impostazione di un link modifica lo stile del testo in modo che sia sottolineato e abbia un colore di primo piano Theme. Puoi modificare questa opzione tramite set e set.
Poiché i link non possono essere impostati sui caratteri di nuova riga, questi ultimi in Text
vengono ignorati.
// Set a link to the URL. const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText(); textRange.getTextStyle().setLinkUrl('https://slides.google.com');
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
url | String | La stringa URL. |
Indietro
Text: questo Text, per il concatenamento.
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 Small Caps(smallCaps)
Specifica se il testo viene visualizzato in piccole lettere maiuscole.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
small | Boolean | Indica se eseguire il rendering del testo in piccole lettere maiuscole. |
Indietro
Text: questo Text, per il concatenamento.
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 Strikethrough(strikethrough)
Imposta se il testo è barrato.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
strikethrough | Boolean | Indica se il testo deve essere barrato. |
Indietro
Text: questo Text, per il concatenamento.
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 Underline(underline)
Imposta se il testo è sottolineato.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
underline | Boolean | Se sottolineare il testo. |
Indietro
Text: questo Text, per il concatenamento.
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