Lo stile del testo.
I metodi di lettura in questa classe restituiscono null
se i valori TextRange
corrispondenti
più esecuzioni di testo, che hanno valori diversi per il metodo di lettura chiamato. A
evita questo problema, esegui una query per gli stili di testo utilizzando gli attributi TextRange
restituiti dal metodo TextRange.getRuns()
.
Se utilizzi metodi che modificano il modo in cui il testo si adatta a una forma, tutte le impostazioni di adattamento automatico applicate gli stili di testo sono disattivati.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
getBackgroundColor() | Color | Restituisce il colore di sfondo del testo o null se sono presenti più stili nella
testo. |
getBaselineOffset() | TextBaselineOffset | Restituisce l'offset verticale del testo dalla sua posizione normale o null se sono presenti
più stili per il testo. |
getFontFamily() | String | Restituisce la famiglia di caratteri del testo o null se sono presenti più stili per il testo. |
getFontSize() | Number | Restituisce la dimensione del carattere del testo in punti o null se sono attivi più stili
il testo. |
getFontWeight() | Integer | Restituisce lo spessore del carattere del testo o null se sono presenti più stili per il testo. |
getForegroundColor() | Color | Restituisce il colore in primo piano del testo o null se sono presenti più stili nella
testo. |
getLink() | Link | Restituisce Link nel testo o null se non è presente alcun link o se il link è attivo
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 si trova in una parte del testo oppure sono presenti più link. |
isBackgroundTransparent() | Boolean | Restituisce true se lo sfondo del testo è trasparente, false in caso contrario oppure
null se sono presenti più stili nel testo. |
isBold() | Boolean | Restituisce true se il testo viene visualizzato in grassetto, false in caso contrario o null se
ci sono più stili per il testo. |
isItalic() | Boolean | Restituisce true se il testo è in corsivo, false in caso contrario o null se è presente
esistono più stili per il testo. |
isSmallCaps() | Boolean | Restituisce true se il testo è in minuscolo, false in caso contrario o null se sono presenti più stili per il testo. |
isStrikethrough() | Boolean | Restituisce true se il testo è barrato, false in caso contrario o null se il testo è barrato.
ci sono più stili per il testo. |
isUnderline() | Boolean | Restituisce true se il testo è sottolineato, false in caso contrario o null se è presente
esistono più stili per il testo. |
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 | Consente di impostare 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 in 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 è in corsivo. |
setLinkSlide(slideIndex) | TextStyle | Imposta un Link per il Slide specificato utilizzando l'indice in base zero della slide. |
setLinkSlide(slide) | TextStyle | Imposta un Link sul Slide specificato, il link viene impostato in base all'ID slide specificato. |
setLinkSlide(slidePosition) | TextStyle | Imposta un Link per il Slide specificato utilizzando la posizione relativa della slide. |
setLinkUrl(url) | TextStyle | Imposta un Link sulla stringa URL non vuota specificata. |
setSmallCaps(smallCaps) | TextStyle | Consente di impostare se il testo viene visualizzato in lettere maiuscole. |
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 nella
testo.
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
getBaselineOffset()
Restituisce l'offset verticale del testo dalla sua posizione normale o null
se sono presenti
più stili per il testo.
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
getFontFamily()
Restituisce la famiglia di caratteri del testo o null
se sono presenti più stili per il testo.
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
getFontSize()
Restituisce la dimensione del carattere del testo in punti o null
se sono attivi più stili
il testo.
Invio
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 sono presenti più stili per il testo.
Il peso è un multiplo di 100 compreso tra 100 e 900 inclusi. Questo intervallo corrisponde
i valori numerici descritti nella specifica CSS 2.1, sezione 15.6, con
valori non numerici non consentiti. Le ponderazioni superiori o uguali a 700 sono considerate in grassetto, in
In questo caso isBold()
restituisce true
. Il valore predefinito è 400
("normale").
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
getForegroundColor()
Restituisce il colore in primo piano del testo o null
se sono presenti più stili nella
testo.
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
getLink()
Restituisce Link
nel testo o null
se non è presente alcun link o se il link è attivo
parte del testo o se sono presenti più link. Chiama il numero hasLink()
per stabilire se
il testo non ha link.
var textLink = shape.getText().getTextStyle().getLink(); if (textLink != null) { Logger.log('Shape text has a link of type: ' + textLink.getLinkType()); }
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
hasLink()
Restituisce true
se è presente un link nel testo, false
in caso contrario o null
se
il link si trova in una parte del testo oppure sono presenti più link.
I link non possono essere impostati su caratteri di nuova riga. Di conseguenza, se TextRange
contiene un valore
carattere di nuova riga, questo metodo restituisce sempre null
o false
.
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
isBackgroundTransparent()
Restituisce true
se lo sfondo del testo è trasparente, false
in caso contrario oppure
null
se sono presenti più stili nel testo.
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
isBold()
Restituisce true
se il testo viene visualizzato in grassetto, false
in caso contrario o null
se
ci sono più stili per il testo.
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
isItalic()
Restituisce true
se il testo è in corsivo, false
in caso contrario o null
se è presente
esistono più stili per il testo.
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
isSmallCaps()
Restituisce true
se il testo è in minuscolo, false
in caso contrario o null
se sono presenti più stili per il testo.
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
isStrikethrough()
Restituisce true
se il testo è barrato, false
in caso contrario o null
se il testo è barrato.
ci sono più stili per il testo.
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
isUnderline()
Restituisce true
se il testo è sottolineato, false
in caso contrario o null
se è presente
esistono più stili per il testo.
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
removeLink()
setBackgroundColor(color)
Imposta il colore di sfondo del testo.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | Color |
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
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 |
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
setBackgroundColor(hexColor)
Imposta il colore di sfondo del testo sulla stringa di colore esadecimale specificata.
La stringa esadecimale deve essere nel formato "#RRGGBB". Ad esempio, rosa sarebbe rappresentato come '#FFC0CB'.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
hexColor | String |
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
setBackgroundColor(color)
Imposta il colore di sfondo del testo sul valore ThemeColorType
specificato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | ThemeColorType |
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
setBackgroundColorTransparent()
setBaselineOffset(offset)
Consente di impostare l'offset verticale del testo rispetto alla sua posizione normale.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
offset | TextBaselineOffset |
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
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 |
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
setFontFamily(fontFamily)
Imposta la famiglia di caratteri del testo .
Parametri
Nome | Tipo | Descrizione |
---|---|---|
fontFamily | String |
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
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
i valori numerici descritti nella specifica CSS 2.1, sezione 15.6, con
valori non numerici non consentiti. Le ponderazioni superiori o uguali a 700 sono considerate in grassetto, in
In questo caso isBold()
restituisce true
. Il valore predefinito è 400
("normale").
Parametri
Nome | Tipo | Descrizione |
---|---|---|
fontFamily | String | |
fontWeight | Integer |
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
setFontSize(fontSize)
Imposta la dimensione del carattere del testo, in punti.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
fontSize | Number |
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
setForegroundColor(foregroundColor)
Imposta il colore di primo piano del testo.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
foregroundColor | Color |
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
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 |
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
setForegroundColor(hexColor)
Imposta il colore in primo piano del testo sulla stringa di colore esadecimale specificata.
La stringa esadecimale deve essere nel formato "#RRGGBB". Ad esempio, rosa sarebbe rappresentato come '#FFC0CB'.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
hexColor | String |
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
setForegroundColor(color)
Imposta il colore di primo piano del testo sul valore ThemeColorType
specificato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | ThemeColorType |
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
setItalic(italic)
Consente di impostare se il testo è in corsivo.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
italic | Boolean |
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
setLinkSlide(slideIndex)
Imposta un Link
per il Slide
specificato utilizzando l'indice in base zero della slide.
L'impostazione di un link modifica lo stile del testo in modo che venga sottolineato e abbia il colore in primo piano ThemeColorType.HYPERLINK
. Questa opzione può essere modificata tramite setForegroundColor(hexColor)
e setUnderline(underline)
.
Poiché i link non possono essere impostati su caratteri di nuova riga, questi caratteri 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 della slide. |
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
setLinkSlide(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 venga sottolineato e abbia il colore in primo piano ThemeColorType.HYPERLINK
. Questa opzione può essere modificata tramite setForegroundColor(hexColor)
e setUnderline(underline)
.
Poiché i link non possono essere impostati su caratteri di nuova riga, questi caratteri 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. |
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
setLinkSlide(slidePosition)
Imposta un Link
per il Slide
specificato utilizzando la posizione relativa della slide.
L'impostazione di un link modifica lo stile del testo in modo che venga sottolineato e abbia il colore in primo piano ThemeColorType.HYPERLINK
. Questa opzione può essere modificata tramite setForegroundColor(hexColor)
e setUnderline(underline)
.
Poiché i link non possono essere impostati su caratteri di nuova riga, questi caratteri 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 | L'elemento SlidePosition relativo. |
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
setLinkUrl(url)
Imposta un Link
sulla stringa URL non vuota specificata.
L'impostazione di un link modifica lo stile del testo in modo che venga sottolineato e abbia il colore in primo piano ThemeColorType.HYPERLINK
. Questa opzione può essere modificata tramite setForegroundColor(hexColor)
e setUnderline(underline)
.
Poiché i link non possono essere impostati su caratteri di nuova riga, questi caratteri 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. |
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
setSmallCaps(smallCaps)
Consente di impostare se il testo viene visualizzato in lettere maiuscole.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
smallCaps | Boolean |
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
setStrikethrough(strikethrough)
Consente di impostare se il testo viene barrato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
strikethrough | Boolean |
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
setUnderline(underline)
Consente di impostare se il testo è sottolineato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
underline | Boolean |
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