Class TextStyle

Stiletesto

Lo stile del testo.

I metodi di lettura in questa classe restituiscono null se l'elemento TextRange corrispondente si estende su più esecuzioni di testo e queste hanno valori diversi per il metodo di lettura chiamato. Per evitare questo problema, esegui query per gli stili di testo utilizzando TextRange restituiti dal metodo TextRange.getRuns().

Se utilizzi metodi che modificano l'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()Color|nullRestituisce il colore di sfondo del testo o null se il testo ha più stili.
getBaselineOffset()TextBaselineOffset|nullRestituisce l'offset verticale del testo dalla sua posizione normale o null se il testo ha più stili.
getFontFamily()String|nullRestituisce la famiglia di caratteri del testo o null se il testo ha più stili.
getFontSize()Number|nullRestituisce le dimensioni del carattere del testo in punti o null se il testo presenta più stili.
getFontWeight()Integer|nullRestituisce lo spessore del carattere del testo o null se il testo ha più stili.
getForegroundColor()Color|nullRestituisce il colore del testo in primo piano o null se il testo ha più stili.
getLink()Link|nullRestituisce il Link sul testo oppure null se non è presente alcun link o se il link si trova su parte del testo o se sono presenti più link.
hasLink()Boolean|nullRestituisce true se il testo contiene un link, false in caso contrario o null se il link si trova in una parte del testo o se sono presenti più link.
isBackgroundTransparent()Boolean|nullRestituisce true se lo sfondo del testo è trasparente, false in caso contrario o null se il testo presenta più stili.
isBold()Boolean|nullRestituisce true se il testo viene visualizzato in grassetto, false in caso contrario o null se il testo ha più stili.
isItalic()Boolean|nullRestituisce true se il testo è in corsivo, false in caso contrario o null se il testo ha più stili.
isSmallCaps()Boolean|nullRestituisce true se il testo è in piccole maiuscole, false in caso contrario o null se il testo presenta più stili.
isStrikethrough()Boolean|nullRestituisce true se il testo è barrato, false in caso contrario o null se il testo ha più stili.
isUnderline()Boolean|nullRestituisce true se il testo è sottolineato, false in caso contrario o null se sono presenti più stili nel 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 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)TextStyleImposta se il testo deve essere visualizzato in grassetto.
setFontFamily(fontFamily)TextStyleImposta la famiglia di caratteri del testo .
setFontFamilyAndWeight(fontFamily, fontWeight)TextStyleImposta la famiglia e il peso del carattere del testo.
setFontSize(fontSize)TextStyleImposta la dimensione del carattere del testo, in punti.
setForegroundColor(foregroundColor)TextStyleImposta il colore del testo in primo piano.
setForegroundColor(red, green, blue)TextStyleImposta il colore del testo in primo piano 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 testo in primo piano sul valore ThemeColorType specificato.
setItalic(italic)TextStyleImposta se il testo è in corsivo.
setLinkSlide(slideIndex)TextStyleImposta un Link sul Slide specificato utilizzando l'indice della slide basato su zero.
setLinkSlide(slide)TextStyleImposta un Link sul Slide specificato. Il link viene impostato dall'ID slide specificato.
setLinkSlide(slidePosition)TextStyleImposta un Link sul Slide specificato utilizzando la posizione relativa della slide.
setLinkUrl(url)TextStyleImposta un Link sulla stringa URL non vuota specificata.
setSmallCaps(smallCaps)TextStyleImposta se il testo viene visualizzato in caratteri maiuscoli di piccole dimensioni.
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.

Indietro

Color|null

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

Indietro

TextBaselineOffset|null

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

Indietro

String|null

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

Indietro

Number|null

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 specifica CSS 2.1, sezione 15.6, con valori non numerici non consentiti. I pesi maggiori o uguali a 700 sono considerati in grassetto, nel qual caso isBold() restituisce true. Il valore predefinito è 400 ("normale").

Indietro

Integer|null

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 del testo in primo piano o null se il testo ha più stili.

Indietro

Color|null

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 il Link sul testo oppure 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()}`);
}

Indietro

Link|null

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

Indietro

Boolean|null

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.

Indietro

Boolean|null

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

Indietro

Boolean|null

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.

Indietro

Boolean|null

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

Indietro

Boolean|null

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.

Indietro

Boolean|null

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

Indietro

Boolean|null

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 e dello stile di sottolineatura del link ipertestuale sul testo. Se possibile, questi stili vengono applicati in modo che corrispondano al testo che precede il link. 

const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.getTextStyle().removeLink();

Indietro

TextStyle

setBackgroundColor(color)

Imposta il colore di sfondo del testo.

Parametri

NomeTipoDescrizione
colorColor

Indietro

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

Indietro

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 sarebbe rappresentato da '#FFC0CB'.

Parametri

NomeTipoDescrizione
hexColorString

Indietro

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 ThemeColorType specificato.

Parametri

NomeTipoDescrizione
colorThemeColorType

Indietro

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.

Indietro

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

Indietro

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.

Se modifichi il grassetto del testo, viene aggiornato lo spessore del carattere utilizzato per il rendering del testo.

Parametri

NomeTipoDescrizione
boldBoolean

Indietro

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

Indietro

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 e il peso del carattere del testo.

Il peso è un multiplo di 100 compreso tra 100 e 900 inclusi. Questo intervallo corrisponde ai valori numerici descritti nella specifica CSS 2.1, sezione 15.6, con valori non numerici non consentiti. I pesi maggiori o uguali a 700 sono considerati in grassetto, nel qual caso isBold() restituisce true. Il valore predefinito è 400 ("normale").

Parametri

NomeTipoDescrizione
fontFamilyString
fontWeightInteger

Indietro

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

Indietro

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 testo in primo piano.

Parametri

NomeTipoDescrizione
foregroundColorColor

Indietro

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 del testo in primo piano sui valori RGB specificati da 0 a 255.

Parametri

NomeTipoDescrizione
redInteger
greenInteger
blueInteger

Indietro

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 sarebbe rappresentato da '#FFC0CB'.

Parametri

NomeTipoDescrizione
hexColorString

Indietro

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 testo in primo piano sul valore ThemeColorType specificato.

Parametri

NomeTipoDescrizione
colorThemeColorType

Indietro

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

Indietro

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 Slide specificato utilizzando l'indice della slide basato su zero.

L'impostazione di un link modifica lo stile del testo in modo che sia sottolineato e abbia un colore di primo piano ThemeColorType.HYPERLINK. Puoi modificare questa opzione tramite setForegroundColor(hexColor) e setUnderline(underline).

Poiché i link non possono essere impostati sui caratteri di nuova riga, questi ultimi 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 in base zero della slide.

Indietro

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 dall'ID slide specificato.

L'impostazione di un link modifica lo stile del testo in modo che sia sottolineato e abbia un colore di primo piano ThemeColorType.HYPERLINK. Puoi modificare questa opzione tramite setForegroundColor(hexColor) e setUnderline(underline).

Poiché i link non possono essere impostati sui caratteri di nuova riga, questi ultimi 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'account Slide da collegare.

Indietro

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

L'impostazione di un link modifica lo stile del testo in modo che sia sottolineato e abbia un colore di primo piano ThemeColorType.HYPERLINK. Puoi modificare questa opzione tramite setForegroundColor(hexColor) e setUnderline(underline).

Poiché i link non possono essere impostati sui caratteri di nuova riga, questi ultimi 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.

Indietro

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 sia sottolineato e abbia un colore di primo piano ThemeColorType.HYPERLINK. Puoi modificare questa opzione tramite setForegroundColor(hexColor) e setUnderline(underline).

Poiché i link non possono essere impostati sui caratteri di nuova riga, questi ultimi 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 URL.

Indietro

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 viene visualizzato in caratteri maiuscoli di piccole dimensioni.

Parametri

NomeTipoDescrizione
smallCapsBoolean

Indietro

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

Indietro

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

Indietro

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