Class TextStyle

TextStyle

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

MetodoTipo restituitoBreve descrizione
getBackgroundColor()ColorRestituisce il colore di sfondo del testo o null se sono presenti più stili nel testo.
getBaselineOffset()TextBaselineOffsetRestituisce l'offset verticale del testo dalla sua posizione normale o null se il testo contiene più stili.
getFontFamily()StringRestituisce la famiglia di caratteri del testo o null se sono presenti più stili nel testo.
getFontSize()NumberRestituisce la dimensione del carattere del testo in punti o null se ci sono più stili per il testo.
getFontWeight()IntegerRestituisce lo spessore del carattere del testo o null se ci sono più stili nel testo.
getForegroundColor()ColorRestituisce il colore di primo piano del testo o null se sono presenti più stili sul testo.
getLink()LinkRestituisce 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()BooleanRestituisce 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()BooleanRestituisce true se lo sfondo del testo è trasparente, false in caso contrario o null se sono presenti più stili sul testo.
isBold()BooleanRestituisce true se il testo viene visualizzato in grassetto, false in caso contrario o null se il testo è visualizzato in più stili.
isItalic()BooleanRestituisce true se il testo è in corsivo, false in caso contrario o null se il testo è presente in più stili.
isSmallCaps()BooleanRestituisce true se il testo è in lettere maiuscole, false in caso contrario o null se ci sono più stili per il testo.
isStrikethrough()BooleanRestituisce true se il testo è barrato, false in caso contrario o null se il testo è presente più stili.
isUnderline()BooleanRestituisce true se il testo è sottolineato, false in caso contrario o null se il testo è presente più stili.
removeLink()TextStyleRimuove un Link.
setBackgroundColor(color)TextStyleImposta il colore di sfondo del testo.
setBackgroundColor(red, green, blue)TextStyleImposta il colore di sfondo del testo sui valori RGB specificati da 0 a 255.
setBackgroundColor(hexColor)TextStyleImposta il colore di sfondo del testo sulla stringa di colore esadecimale specificata.
setBackgroundColor(color)TextStyleImposta il colore di sfondo del testo sul valore ThemeColorType specificato.
setBackgroundColorTransparent()TextStyleImposta il colore di sfondo del testo su trasparente.
setBaselineOffset(offset)TextStyleImposta l'offset verticale del testo rispetto alla sua posizione normale.
setBold(bold)TextStyleConsente di impostare se il testo deve essere visualizzato in grassetto.
setFontFamily(fontFamily)TextStyleImposta la famiglia di caratteri del testo .
setFontFamilyAndWeight(fontFamily, fontWeight)TextStyleImposta la famiglia di caratteri e lo spessore del testo.
setFontSize(fontSize)TextStyleImposta la dimensione del carattere del testo in punti.
setForegroundColor(foregroundColor)TextStyleImposta il colore di primo piano del testo.
setForegroundColor(red, green, blue)TextStyleImposta il colore di primo piano del testo sui valori RGB specificati da 0 a 255.
setForegroundColor(hexColor)TextStyleImposta il colore di primo piano del testo sulla stringa di colore esadecimale specificata.
setForegroundColor(color)TextStyleImposta il colore di primo piano del testo sul valore ThemeColorType specificato.
setItalic(italic)TextStyleConsente di impostare se il testo deve essere in corsivo.
setLinkSlide(slideIndex)TextStyleImposta un Link sul valore Slide specificato utilizzando l'indice in base zero della slide.
setLinkSlide(slide)TextStyleImposta un Link sul valore Slide specificato. Il collegamento viene impostato dall'ID slide specificato.
setLinkSlide(slidePosition)TextStyleImposta un Link sul valore Slide specificato utilizzando la posizione relativa della slide.
setLinkUrl(url)TextStyleImposta un valore Link sulla stringa URL non vuota specificata.
setSmallCaps(smallCaps)TextStyleConsente di impostare se il testo viene visualizzato in lettere maiuscole piccole.
setStrikethrough(strikethrough)TextStyleConsente di impostare se il testo viene barrato.
setUnderline(underline)TextStyleConsente 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

Color

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

TextBaselineOffset

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

Color

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

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

Link

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

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

Rimuove un Link.

La rimozione di un link comporta la rimozione del colore in primo piano e dello stile di sottolineatura dal testo. Se possibile, questi stili vengono applicati in modo che corrispondano al testo che precede il link. 

text.getTextStyle().removeLink();

Ritorni

TextStyle

setBackgroundColor(color)

Imposta il colore di sfondo del testo.

Parametri

NomeTipoDescrizione
colorColor

Ritorni

TextStyle

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

NomeTipoDescrizione
redInteger
greenInteger
blueInteger

Ritorni

TextStyle

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

NomeTipoDescrizione
hexColorString

Ritorni

TextStyle

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

NomeTipoDescrizione
colorThemeColorType

Ritorni

TextStyle

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()

Imposta il colore di sfondo del testo su trasparente.

Ritorni

TextStyle

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

setBaselineOffset(offset)

Imposta l'offset verticale del testo rispetto alla sua posizione normale.

Parametri

NomeTipoDescrizione
offsetTextBaselineOffset

Ritorni

TextStyle

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

NomeTipoDescrizione
boldBoolean

Ritorni

TextStyle

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

NomeTipoDescrizione
fontFamilyString

Ritorni

TextStyle

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

NomeTipoDescrizione
fontFamilyString
fontWeightInteger

Ritorni

TextStyle

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

NomeTipoDescrizione
fontSizeNumber

Ritorni

TextStyle

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

NomeTipoDescrizione
foregroundColorColor

Ritorni

TextStyle

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

NomeTipoDescrizione
redInteger
greenInteger
blueInteger

Ritorni

TextStyle

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

NomeTipoDescrizione
hexColorString

Ritorni

TextStyle

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

NomeTipoDescrizione
colorThemeColorType

Ritorni

TextStyle

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

NomeTipoDescrizione
italicBoolean

Ritorni

TextStyle

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

NomeTipoDescrizione
slideIndexIntegerL'indice in base zero alla slide.

Ritorni

TextStyle

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

NomeTipoDescrizione
slideSlideSlide da collegare.

Ritorni

TextStyle

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

NomeTipoDescrizione
slidePositionSlidePositionIl relativo SlidePosition.

Ritorni

TextStyle

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

NomeTipoDescrizione
urlStringLa stringa dell'URL.

Ritorni

TextStyle

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

NomeTipoDescrizione
smallCapsBoolean

Ritorni

TextStyle

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

NomeTipoDescrizione
strikethroughBoolean

Ritorni

TextStyle

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

NomeTipoDescrizione
underlineBoolean

Ritorni

TextStyle

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