Lo stile del testo.
I metodi di lettura in questa classe restituiscono null
se il TextRange
corrispondente copre
più esecuzioni di testo e quelle esecuzioni hanno valori diversi per il metodo di lettura chiamato. Per evitare che ciò accada, esegui una query sugli stili di testo utilizzando i TextRange
restituiti dal metodo TextRange.getRuns()
.
Se utilizzi metodi che modificano la modalità di 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 |
---|---|---|
getBackgroundColor() | Color | Restituisce il colore di sfondo del testo o null se sono presenti più stili nel testo. |
getBaselineOffset() | TextBaselineOffset | Restituisce l'offset verticale del testo dalla sua posizione normale o null se il testo contiene più stili. |
getFontFamily() | String | Restituisce la famiglia di caratteri del testo o null se sono presenti più stili nel testo. |
getFontSize() | Number | Restituisce la dimensione del carattere del testo in punti o null se ci sono più stili per il testo. |
getFontWeight() | Integer | Restituisce lo spessore del carattere del testo o null se ci sono più stili nel testo. |
getForegroundColor() | Color | Restituisce il colore di primo piano del testo o null se sono presenti più stili sul testo. |
getLink() | Link | Restituisce Link nel testo o null se non è presente alcun link, se il link si trova in una parte del testo o se sono presenti più link. |
hasLink() | Boolean | Restituisce true se è presente un link nel testo, false in caso contrario o null se il link è incluso in una parte del testo o se sono presenti più link. |
isBackgroundTransparent() | Boolean | Restituisce true se lo sfondo del testo è trasparente, false in caso contrario o null se sono presenti più stili sul testo. |
isBold() | Boolean | Restituisce true se il testo viene visualizzato in grassetto, false in caso contrario o null se il testo è visualizzato in più stili. |
isItalic() | Boolean | Restituisce true se il testo è in corsivo, false in caso contrario o null se il testo è presente in più stili. |
isSmallCaps() | Boolean | Restituisce true se il testo è in lettere maiuscole, false in caso contrario o null se ci sono più stili per il testo. |
isStrikethrough() | Boolean | Restituisce true se il testo è barrato, false in caso contrario o null se il testo è presente più stili. |
isUnderline() | Boolean | Restituisce true se il testo è sottolineato, false in caso contrario o null se il testo è presente più stili. |
removeLink() | TextStyle | Rimuove un Link . |
setBackgroundColor(color) | TextStyle | Imposta il colore di sfondo del testo. |
setBackgroundColor(red, green, blue) | TextStyle | Imposta il colore di sfondo del testo sui valori RGB specificati da 0 a 255. |
setBackgroundColor(hexColor) | TextStyle | Imposta il colore di sfondo del testo sulla stringa di colore esadecimale specificata. |
setBackgroundColor(color) | TextStyle | Imposta il colore di sfondo del testo sul valore ThemeColorType specificato. |
setBackgroundColorTransparent() | TextStyle | Imposta il colore di sfondo del testo su trasparente. |
setBaselineOffset(offset) | TextStyle | Imposta l'offset verticale del testo rispetto alla sua posizione normale. |
setBold(bold) | TextStyle | Consente di impostare se il testo deve essere visualizzato in grassetto. |
setFontFamily(fontFamily) | TextStyle | Imposta la famiglia di caratteri del testo . |
setFontFamilyAndWeight(fontFamily, fontWeight) | TextStyle | Imposta la famiglia di caratteri e lo spessore del testo. |
setFontSize(fontSize) | TextStyle | Imposta la dimensione del carattere del testo in punti. |
setForegroundColor(foregroundColor) | TextStyle | Imposta il colore di primo piano del testo. |
setForegroundColor(red, green, blue) | TextStyle | Imposta il colore di primo piano del testo sui valori RGB specificati da 0 a 255. |
setForegroundColor(hexColor) | TextStyle | Imposta il colore di primo piano del testo sulla stringa di colore esadecimale specificata. |
setForegroundColor(color) | TextStyle | Imposta il colore di primo piano del testo sul valore ThemeColorType specificato. |
setItalic(italic) | TextStyle | Consente di impostare se il testo deve essere in corsivo. |
setLinkSlide(slideIndex) | TextStyle | Imposta un Link sul valore Slide specificato utilizzando l'indice in base zero della slide. |
setLinkSlide(slide) | TextStyle | Imposta un Link sul valore Slide specificato. Il collegamento viene impostato dall'ID slide specificato. |
setLinkSlide(slidePosition) | TextStyle | Imposta un Link sul valore Slide specificato utilizzando la posizione relativa della slide. |
setLinkUrl(url) | TextStyle | Imposta un valore Link sulla stringa URL non vuota specificata. |
setSmallCaps(smallCaps) | TextStyle | Consente di impostare se il testo viene visualizzato in lettere maiuscole piccole. |
setStrikethrough(strikethrough) | TextStyle | Consente di impostare se il testo viene barrato. |
setUnderline(underline) | TextStyle | Consente di impostare se il testo è sottolineato. |
Documentazione dettagliata
getBackgroundColor()
Restituisce il colore di sfondo del testo o null
se sono presenti più stili nel testo.
Ritorni
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
getBaselineOffset()
Restituisce l'offset verticale del testo dalla sua posizione normale o null
se il testo contiene più stili.
Ritorni
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
getFontFamily()
Restituisce la famiglia di caratteri del testo o null
se sono presenti più stili nel testo.
Ritorni
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
getFontSize()
Restituisce la dimensione del carattere del testo in punti o null
se ci sono più stili per il testo.
Ritorni
Number
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
getFontWeight()
Restituisce lo spessore del carattere del testo o null
se ci sono più stili nel testo.
Il peso è un multiplo di 100 compreso tra 100 e 900 inclusi. Questo intervallo corrisponde ai valori numerici descritti nella sezione 15.6 della specifica CSS 2.1, con valori non numerici non consentiti. Le ponderazioni maggiori o uguali a 700 sono considerate in grassetto, nel qual caso isBold()
restituisce true
. Il valore predefinito è 400 ("normale").
Ritorni
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
getForegroundColor()
Restituisce il colore di primo piano del testo o null
se sono presenti più stili sul testo.
Ritorni
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
getLink()
Restituisce Link
nel testo o null
se non è presente alcun link, se il link si trova in una parte del testo o se sono presenti più link. Richiama hasLink()
per determinare se
il testo non contiene un link.
var textLink = shape.getText().getTextStyle().getLink(); if (textLink != null) { Logger.log('Shape text has a link of type: ' + textLink.getLinkType()); }
Ritorni
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
hasLink()
Restituisce true
se è presente un link nel testo, false
in caso contrario o null
se il link è incluso in una parte del testo o se sono presenti più link.
I link non possono essere impostati su caratteri di nuova riga. Pertanto, se TextRange
contiene un carattere
di nuova riga, questo metodo restituisce sempre null
o false
.
Ritorni
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
isBackgroundTransparent()
Restituisce true
se lo sfondo del testo è trasparente, false
in caso contrario o null
se sono presenti più stili sul testo.
Ritorni
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
isBold()
Restituisce true
se il testo viene visualizzato in grassetto, false
in caso contrario o null
se il testo è visualizzato in più stili.
Ritorni
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
isItalic()
Restituisce true
se il testo è in corsivo, false
in caso contrario o null
se il testo è presente in più stili.
Ritorni
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
isSmallCaps()
Restituisce true
se il testo è in lettere maiuscole, false
in caso contrario o null
se ci sono più stili per il testo.
Ritorni
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
isStrikethrough()
Restituisce true
se il testo è barrato, false
in caso contrario o null
se il testo è presente più stili.
Ritorni
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
isUnderline()
Restituisce true
se il testo è sottolineato, false
in caso contrario o null
se il testo è presente più stili.
Ritorni
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
removeLink()
setBackgroundColor(color)
Imposta il colore di sfondo del testo.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | Color |
Ritorni
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
setBackgroundColor(red, green, blue)
Imposta il colore di sfondo del testo sui valori RGB specificati da 0 a 255.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
red | Integer | |
green | Integer | |
blue | Integer |
Ritorni
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
setBackgroundColor(hexColor)
Imposta il colore di sfondo del testo sulla stringa di colore esadecimale specificata.
Il formato della stringa esadecimale deve essere "#RRGGBB". Ad esempio, rosa sarebbe rappresentato come "#FFC0CB".
Parametri
Nome | Tipo | Descrizione |
---|---|---|
hexColor | String |
Ritorni
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
setBackgroundColor(color)
Imposta il colore di sfondo del testo sul valore ThemeColorType
specificato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | ThemeColorType |
Ritorni
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
setBackgroundColorTransparent()
setBaselineOffset(offset)
Imposta l'offset verticale del testo rispetto alla sua posizione normale.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
offset | TextBaselineOffset |
Ritorni
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
setBold(bold)
Consente di impostare se il testo deve essere visualizzato in grassetto.
La modifica del grassetto del testo aggiorna lo spessore del carattere utilizzato per il rendering del testo.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
bold | Boolean |
Ritorni
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
setFontFamily(fontFamily)
Imposta la famiglia di caratteri del testo .
Parametri
Nome | Tipo | Descrizione |
---|---|---|
fontFamily | String |
Ritorni
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
setFontFamilyAndWeight(fontFamily, fontWeight)
Imposta la famiglia di caratteri e lo spessore del testo.
Il peso è un multiplo di 100 compreso tra 100 e 900 inclusi. Questo intervallo corrisponde ai valori numerici descritti nella sezione 15.6 della specifica CSS 2.1, con valori non numerici non consentiti. Le ponderazioni maggiori o uguali a 700 sono considerate in grassetto, nel qual caso isBold()
restituisce true
. Il valore predefinito è 400 ("normale").
Parametri
Nome | Tipo | Descrizione |
---|---|---|
fontFamily | String | |
fontWeight | Integer |
Ritorni
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
setFontSize(fontSize)
Imposta la dimensione del carattere del testo in punti.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
fontSize | Number |
Ritorni
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
setForegroundColor(foregroundColor)
Imposta il colore di primo piano del testo.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
foregroundColor | Color |
Ritorni
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
setForegroundColor(red, green, blue)
Imposta il colore di primo piano del testo sui valori RGB specificati da 0 a 255.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
red | Integer | |
green | Integer | |
blue | Integer |
Ritorni
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
setForegroundColor(hexColor)
Imposta il colore di primo piano del testo sulla stringa di colore esadecimale specificata.
Il formato della stringa esadecimale deve essere "#RRGGBB". Ad esempio, rosa sarebbe rappresentato come "#FFC0CB".
Parametri
Nome | Tipo | Descrizione |
---|---|---|
hexColor | String |
Ritorni
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
setForegroundColor(color)
Imposta il colore di primo piano del testo sul valore ThemeColorType
specificato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | ThemeColorType |
Ritorni
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
setItalic(italic)
Consente di impostare se il testo deve essere in corsivo.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
italic | Boolean |
Ritorni
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
setLinkSlide(slideIndex)
Imposta un Link
sul valore Slide
specificato utilizzando l'indice in base zero della slide.
L'impostazione di un link modifica lo stile del testo da sottolineare e dal colore ThemeColorType.HYPERLINK
in primo piano. Questa opzione può essere modificata tramite setForegroundColor(hexColor)
e setUnderline(underline)
.
Poiché i link non possono essere impostati sui caratteri di nuova riga, i caratteri di nuova riga in TextRange
vengono ignorati.
// Set a link to the first slide of the presentation. text.getTextStyle().setLinkSlide(0);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
slideIndex | Integer | L'indice in base zero alla slide. |
Ritorni
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
setLinkSlide(slide)
Imposta un Link
sul valore Slide
specificato. Il collegamento viene impostato dall'ID slide specificato.
L'impostazione di un link modifica lo stile del testo da sottolineare e dal colore ThemeColorType.HYPERLINK
in primo piano. Questa opzione può essere modificata tramite setForegroundColor(hexColor)
e setUnderline(underline)
.
Poiché i link non possono essere impostati sui caratteri di nuova riga, i caratteri di nuova riga in TextRange
vengono ignorati.
// Set a link to the first slide of the presentation. var slide = presentation.getSlides()[0]; text.getTextStyle().setLinkSlide(slide);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
slide | Slide | Slide da collegare. |
Ritorni
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
setLinkSlide(slidePosition)
Imposta un Link
sul valore Slide
specificato utilizzando la posizione relativa della slide.
L'impostazione di un link modifica lo stile del testo da sottolineare e dal colore ThemeColorType.HYPERLINK
in primo piano. Questa opzione può essere modificata tramite setForegroundColor(hexColor)
e setUnderline(underline)
.
Poiché i link non possono essere impostati sui caratteri di nuova riga, i caratteri di nuova riga in TextRange
vengono ignorati.
// Set a link to the first slide of the presentation. text.getTextStyle().setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
slidePosition | SlidePosition | Il relativo SlidePosition . |
Ritorni
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
setLinkUrl(url)
Imposta un valore Link
sulla stringa URL non vuota specificata.
L'impostazione di un link modifica lo stile del testo da sottolineare e dal colore ThemeColorType.HYPERLINK
in primo piano. Questa opzione può essere modificata tramite setForegroundColor(hexColor)
e setUnderline(underline)
.
Poiché i link non possono essere impostati sui caratteri di nuova riga, i caratteri di nuova riga in TextRange
vengono ignorati.
// Set a link to the URL. text.getTextStyle().setLinkUrl("https://slides.google.com");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
url | String | La stringa dell'URL. |
Ritorni
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
setSmallCaps(smallCaps)
Consente di impostare se il testo viene visualizzato in lettere maiuscole piccole.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
smallCaps | Boolean |
Ritorni
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
setStrikethrough(strikethrough)
Consente di impostare se il testo viene barrato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
strikethrough | Boolean |
Ritorni
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
setUnderline(underline)
Consente di impostare se il testo è sottolineato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
underline | Boolean |
Ritorni
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