Class TextStyle

StileTesto

Lo stile del testo.

I metodi di lettura in questa classe restituiscono null se il corrispondente TextRange si estende su più esecuzioni di testo e queste esecuzioni hanno valori diversi per il metodo di lettura chiamato. Per evitarlo, esegui una query per gli stili di testo utilizzando gli 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 il testo ha più stili.
getBaselineOffset()TextBaselineOffsetRestituisce lo spazio verticale del testo rispetto alla sua posizione normale o null se il testo ha più stili.
getFontFamily()StringRestituisce la famiglia di caratteri del testo o null se il testo presenta più stili.
getFontSize()NumberRestituisce le dimensioni del carattere del testo in punti o null se sono presenti più stili nel testo.
getFontWeight()IntegerRestituisce lo spessore del carattere del testo o null se il testo ha più stili.
getForegroundColor()ColorRestituisce il colore di primo piano del testo o null se il testo ha più stili.
getLink()LinkRestituisce Link sul testo o null se non è presente alcun link o se il link si trova su parte del testo o se sono presenti più link.
hasLink()BooleanRestituisce true se il testo contiene un link, false in caso contrario o null se il link si trova in 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 il testo presenta più stili.
isBold()BooleanRestituisce true se il testo viene visualizzato in grassetto, false in caso contrario o null se il testo è composto da più stili.
isItalic()BooleanRestituisce true se il testo è in corsivo, false in caso contrario o null se il testo ha più stili.
isSmallCaps()BooleanRestituisce true se il testo è in lettere maiuscole, false in caso contrario o null se il testo è in più stili.
isStrikethrough()BooleanRestituisce true se il testo è barrato, false se non lo è o null se il testo ha più stili.
isUnderline()BooleanRestituisce true se il testo è sottolineato, false in caso contrario o null se il testo ha 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 lo spazio verticale del testo rispetto alla sua posizione normale.
setBold(bold)TextStyleImposta 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 il peso del testo.
setFontSize(fontSize)TextStyleImposta la dimensione del carattere del testo in punti.
setForegroundColor(foregroundColor)TextStyleImposta il colore del 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 del primo piano del testo su ThemeColorType.
setItalic(italic)TextStyleImposta se il testo è in corsivo.
setLinkSlide(slideIndex)TextStyleImposta un Link per il Slide specificato utilizzando l'indice a partire da zero della diapositiva.
setLinkSlide(slide)TextStyleImposta un Link sul Slide specificato. Il link viene impostato in base all'ID slide specificato.
setLinkSlide(slidePosition)TextStyleImposta un Link sul Slide specificato utilizzando la posizione relativa della diapositiva.
setLinkUrl(url)TextStyleImposta un Link sulla stringa URL non vuota specificata.
setSmallCaps(smallCaps)TextStyleImposta se il testo deve essere visualizzato in lettere maiuscole piccole.
setStrikethrough(strikethrough)TextStyleImposta se il testo è barrato.
setUnderline(underline)TextStyleImposta se il testo è sottolineato.

Documentazione dettagliata

getBackgroundColor()

Restituisce il colore di sfondo del testo o null se il testo ha più stili.

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 lo spazio verticale del testo rispetto alla sua posizione normale o null se il testo ha più stili.

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 il testo presenta più stili.

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 le dimensioni del carattere del testo in punti o null se sono presenti più stili nel 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 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 sezione 15.6 della specifica CSS 2.1, con i valori non numerici non consentiti. I pesi maggiori o uguali a 700 sono considerati in grassetto, 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 di primo piano del testo o null se il testo ha più stili.

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 sul testo o null se non è presente alcun link o se il link si trova su parte del testo o se sono presenti più link. Chiama hasLink() 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()}`);
}

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 il testo contiene un link, false in caso contrario o null se il link si trova in parte del testo o se sono presenti più link.

I link non possono essere impostati sui caratteri di nuova riga. Pertanto, se TextRange contiene un carattere di riga nuova, 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 o null se il testo presenta più stili.

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 il testo è composto da più stili.

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 il testo ha più stili.

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 lettere maiuscole, false in caso contrario o null se il testo è in più stili.

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 ha più stili.

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 il testo ha più stili.

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 comporta la rimozione del colore di primo piano del link ipertestuale e dello stile di sottolineatura del testo. Se possibile, questi stili vengono applicati in modo da corrispondere al testo che precede il link. 

const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.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, il rosa viene 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)

Imposta lo spazio 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)

Imposta 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 il peso 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 i valori non numerici non consentiti. I pesi maggiori o uguali a 700 sono considerati in grassetto, 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 del 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 di primo piano del testo sulla stringa di colore esadecimale specificata.

La stringa esadecimale deve essere nel formato "#RRGGBB". Ad esempio, il rosa viene 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 del primo piano del testo su ThemeColorType.

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)

Imposta 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 a partire da zero della diapositiva.

L'impostazione di un link modifica lo stile del testo da sottolineare e ne imposta un colore di primo piano ThemeColorType.HYPERLINK. Questa impostazione può essere modificata tramite setForegroundColor(hexColor) e setUnderline(underline).

Poiché i link non possono essere impostati sui caratteri di a capo, questi caratteri in TextRange 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

NomeTipoDescrizione
slideIndexIntegerL'indice della diapositiva basato su zero.

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 da sottolineare e ne imposta un colore di primo piano ThemeColorType.HYPERLINK. Questa impostazione può essere modificata tramite setForegroundColor(hexColor) e setUnderline(underline).

Poiché i link non possono essere impostati sui caratteri di a capo, questi caratteri in TextRange 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

NomeTipoDescrizione
slideSlideL'Slide 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 sul Slide specificato utilizzando la posizione relativa della diapositiva.

L'impostazione di un link modifica lo stile del testo da sottolineare e ne imposta un colore di primo piano ThemeColorType.HYPERLINK. Questa impostazione può essere modificata tramite setForegroundColor(hexColor) e setUnderline(underline).

Poiché i link non possono essere impostati sui caratteri di a capo, questi caratteri in TextRange 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

NomeTipoDescrizione
slidePositionSlidePositionIl 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 da sottolineare e ne imposta un colore di primo piano ThemeColorType.HYPERLINK. Questa impostazione può essere modificata tramite setForegroundColor(hexColor) e setUnderline(underline).

Poiché i link non possono essere impostati sui caratteri di a capo, questi caratteri in TextRange 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

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)

Imposta se il testo deve essere visualizzato in lettere maiuscole piccole.

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)

Imposta se il testo è 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)

Imposta 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