Class TextStyle

TextStyle

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

MetodoTipo restituitoBreve descrizione
getBackgroundColor()ColorRestituisce il colore di sfondo del testo o null se sono presenti più stili nella testo.
getBaselineOffset()TextBaselineOffsetRestituisce l'offset verticale del testo dalla sua posizione normale o null se sono presenti più stili per il testo.
getFontFamily()StringRestituisce la famiglia di caratteri del testo o null se sono presenti più stili per il testo.
getFontSize()NumberRestituisce la dimensione del carattere del testo in punti o null se sono attivi più stili il testo.
getFontWeight()IntegerRestituisce lo spessore del carattere del testo o null se sono presenti più stili per il testo.
getForegroundColor()ColorRestituisce il colore in primo piano del testo o null se sono presenti più stili nella testo.
getLink()LinkRestituisce 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()BooleanRestituisce 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()BooleanRestituisce true se lo sfondo del testo è trasparente, false in caso contrario oppure null se sono presenti più stili nel testo.
isBold()BooleanRestituisce true se il testo viene visualizzato in grassetto, false in caso contrario o null se ci sono più stili per il testo.
isItalic()BooleanRestituisce true se il testo è in corsivo, false in caso contrario o null se è presente esistono più stili per il testo.
isSmallCaps()BooleanRestituisce true se il testo è in minuscolo, false in caso contrario o null se sono presenti più stili per il testo.
isStrikethrough()BooleanRestituisce true se il testo è barrato, false in caso contrario o null se il testo è barrato. ci sono più stili per il testo.
isUnderline()BooleanRestituisce true se il testo è sottolineato, false in caso contrario o null se è presente esistono più stili per il testo.
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)TextStyleConsente di impostare 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 in 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 è in corsivo.
setLinkSlide(slideIndex)TextStyleImposta un Link per il Slide specificato utilizzando l'indice in base zero della slide.
setLinkSlide(slide)TextStyleImposta un Link sul Slide specificato, il link viene impostato in base all'ID slide specificato.
setLinkSlide(slidePosition)TextStyleImposta un Link per il Slide specificato utilizzando la posizione relativa della slide.
setLinkUrl(url)TextStyleImposta un Link sulla stringa URL non vuota specificata.
setSmallCaps(smallCaps)TextStyleConsente di impostare se il testo viene visualizzato in lettere maiuscole.
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 nella testo.

Invio

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 sono presenti più stili per il testo.

Invio

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

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

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

Rimuove un Link.

La rimozione di un link rimuove il colore in primo piano del link ipertestuale e lo stile di sottolineatura dal testo. Se possibili, questi stili vengono applicati in modo che corrispondano al testo che precede il link. 

text.getTextStyle().removeLink();

Invio

TextStyle

setBackgroundColor(color)

Imposta il colore di sfondo del testo.

Parametri

NomeTipoDescrizione
colorColor

Invio

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

Invio

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.

La stringa esadecimale deve essere nel formato "#RRGGBB". Ad esempio, rosa sarebbe rappresentato come '#FFC0CB'.

Parametri

NomeTipoDescrizione
hexColorString

Invio

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

Invio

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.

Invio

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)

Consente di impostare l'offset verticale del testo rispetto alla sua posizione normale.

Parametri

NomeTipoDescrizione
offsetTextBaselineOffset

Invio

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

Invio

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

Invio

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

NomeTipoDescrizione
fontFamilyString
fontWeightInteger

Invio

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

Invio

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

Invio

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

Invio

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

NomeTipoDescrizione
hexColorString

Invio

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

Invio

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 è in corsivo.

Parametri

NomeTipoDescrizione
italicBoolean

Invio

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

NomeTipoDescrizione
slideIndexIntegerL'indice in base zero della slide.

Invio

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

NomeTipoDescrizione
slideSlideSlide da collegare.

Invio

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

NomeTipoDescrizione
slidePositionSlidePositionL'elemento SlidePosition relativo.

Invio

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

NomeTipoDescrizione
urlStringLa stringa dell'URL.

Invio

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.

Parametri

NomeTipoDescrizione
smallCapsBoolean

Invio

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

Invio

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

Invio

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