Class TextStyle

Style de texte

Style du texte.

Les méthodes de lecture de cette classe renvoient null si le TextRange correspondant s'étend sur plusieurs exécutions de texte et que ces exécutions ont des valeurs différentes pour la méthode de lecture appelée. Pour éviter cela, interrogez les styles de texte à l'aide des TextRange renvoyés par la méthode TextRange.getRuns().

Si vous utilisez des méthodes qui modifient l'ajustement du texte dans une forme, tous les paramètres d'ajustement automatique appliqués aux styles de texte sont désactivés.

Méthodes

MéthodeType renvoyéBrève description
getBackgroundColor()ColorAffiche la couleur d'arrière-plan du texte ou null s'il existe plusieurs styles de texte.
getBaselineOffset()TextBaselineOffsetRenvoie le décalage vertical du texte par rapport à sa position normale, ou null s'il existe plusieurs styles de texte.
getFontFamily()StringAffiche la famille de polices du texte ou null s'il existe plusieurs styles de texte.
getFontSize()NumberRenvoie la taille de la police du texte en points, ou null s'il existe plusieurs styles de texte.
getFontWeight()IntegerRenvoie l'épaisseur de police du texte ou null si le texte comporte plusieurs styles.
getForegroundColor()ColorAffiche la couleur de premier plan du texte ou null s'il existe plusieurs styles de texte.
getLink()LinkRenvoie le Link sur le texte, ou null s'il n'y a pas de lien, ou si le lien ne concerne qu'une partie du texte, ou s'il y a plusieurs liens.
hasLink()BooleanRenvoie true si le texte contient un lien, false si ce n'est pas le cas ou null si le lien ne concerne qu'une partie du texte ou s'il y a plusieurs liens.
isBackgroundTransparent()BooleanRenvoie true si l'arrière-plan du texte est transparent, false si ce n'est pas le cas ou null s'il existe plusieurs styles de texte.
isBold()BooleanRenvoie true si le texte est affiché en gras, false si ce n'est pas le cas ou null s'il existe plusieurs styles de texte.
isItalic()BooleanRenvoie true si le texte est en italique, false si ce n'est pas le cas ou null s'il existe plusieurs styles dans le texte.
isSmallCaps()BooleanRenvoie true si le texte est en petites majuscules, false dans le cas contraire ou null s'il existe plusieurs styles de texte.
isStrikethrough()BooleanRenvoie true si le texte est barré, false si ce n'est pas le cas ou null s'il existe plusieurs styles dans le texte.
isUnderline()BooleanRenvoie true si le texte est souligné, false si ce n'est pas le cas ou null s'il existe plusieurs styles dans le texte.
removeLink()TextStyleSupprime un Link.
setBackgroundColor(color)TextStyleDéfinit la couleur d'arrière-plan du texte.
setBackgroundColor(red, green, blue)TextStyleDéfinit la couleur d'arrière-plan du texte sur les valeurs RVB données, comprises entre 0 et 255.
setBackgroundColor(hexColor)TextStyleDéfinit la couleur d'arrière-plan du texte sur la chaîne de couleur hexadécimale donnée.
setBackgroundColor(color)TextStyleDéfinit la couleur d'arrière-plan du texte sur l'ThemeColorType donnée.
setBackgroundColorTransparent()TextStyleDéfinit la couleur d'arrière-plan du texte sur transparent.
setBaselineOffset(offset)TextStyleDéfinit le décalage vertical du texte par rapport à sa position normale.
setBold(bold)TextStyleIndique si le texte doit être affiché en gras.
setFontFamily(fontFamily)TextStyleDéfinit la famille de polices du texte .
setFontFamilyAndWeight(fontFamily, fontWeight)TextStyleDéfinit la famille de polices et l'épaisseur du texte.
setFontSize(fontSize)TextStyleDéfinit la taille de police du texte, en points.
setForegroundColor(foregroundColor)TextStyleDéfinit la couleur de premier plan du texte.
setForegroundColor(red, green, blue)TextStyleDéfinit la couleur de premier plan du texte sur les valeurs RVB données, comprises entre 0 et 255.
setForegroundColor(hexColor)TextStyleDéfinit la couleur de premier plan du texte sur la chaîne de couleur hexadécimale donnée.
setForegroundColor(color)TextStyleDéfinit la couleur de premier plan du texte sur l'ThemeColorType donnée.
setItalic(italic)TextStyleIndique si le texte est en italique.
setLinkSlide(slideIndex)TextStyleDéfinit un Link sur l'Slide donné à l'aide de l'indice de la diapositive basé sur zéro.
setLinkSlide(slide)TextStyleDéfinit un Link sur l'Slide donné. Le lien est défini par l'ID de diapositive donné.
setLinkSlide(slidePosition)TextStyleDéfinit un Link sur l'Slide donné à l'aide de la position relative de la diapositive.
setLinkUrl(url)TextStyleDéfinit un Link sur la chaîne d'URL non vide donnée.
setSmallCaps(smallCaps)TextStyleIndique si le texte est affiché en petites majuscules.
setStrikethrough(strikethrough)TextStyleIndique si le texte est barré.
setUnderline(underline)TextStyleIndique si le texte est souligné.

Documentation détaillée

getBackgroundColor()

Affiche la couleur d'arrière-plan du texte ou null s'il existe plusieurs styles de texte.

Renvois

Color

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getBaselineOffset()

Renvoie le décalage vertical du texte par rapport à sa position normale, ou null s'il existe plusieurs styles de texte.

Renvois

TextBaselineOffset

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getFontFamily()

Affiche la famille de polices du texte ou null s'il existe plusieurs styles de texte.

Renvois

String

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getFontSize()

Renvoie la taille de la police du texte en points, ou null s'il existe plusieurs styles de texte.

Renvois

Number

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getFontWeight()

Renvoie l'épaisseur de police du texte ou null si le texte comporte plusieurs styles.

La pondération est un multiple de 100 compris entre 100 et 900 inclus. Cette plage correspond aux valeurs numériques décrites dans la spécification CSS 2.1, section 15.6, les valeurs non numériques n'étant pas autorisées. Les poids supérieurs ou égaux à 700 sont considérés comme en gras, auquel cas isBold() renvoie true. La valeur par défaut est 400 (valeur "normal").

Renvois

Integer

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getForegroundColor()

Affiche la couleur de premier plan du texte ou null s'il existe plusieurs styles de texte.

Renvois

Color

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

Renvoie le Link sur le texte, ou null s'il n'y a pas de lien, ou si le lien ne concerne qu'une partie du texte, ou s'il y a plusieurs liens. Appelez hasLink() pour déterminer si le texte ne comporte aucun lien. 

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()}`);
}

Renvois

Link

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

Renvoie true si le texte contient un lien, false si ce n'est pas le cas ou null si le lien ne concerne qu'une partie du texte ou s'il y a plusieurs liens.

Les liens ne peuvent pas être définis sur des caractères de nouvelle ligne. Par conséquent, si TextRange contient un caractère de nouvelle ligne, cette méthode renvoie toujours null ou false.

Renvois

Boolean

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

isBackgroundTransparent()

Renvoie true si l'arrière-plan du texte est transparent, false si ce n'est pas le cas ou null s'il existe plusieurs styles de texte.

Renvois

Boolean

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

isBold()

Renvoie true si le texte est affiché en gras, false si ce n'est pas le cas ou null s'il existe plusieurs styles de texte.

Renvois

Boolean

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

isItalic()

Renvoie true si le texte est en italique, false si ce n'est pas le cas ou null s'il existe plusieurs styles dans le texte.

Renvois

Boolean

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

isSmallCaps()

Renvoie true si le texte est en petites majuscules, false dans le cas contraire ou null s'il existe plusieurs styles de texte.

Renvois

Boolean

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

isStrikethrough()

Renvoie true si le texte est barré, false si ce n'est pas le cas ou null s'il existe plusieurs styles dans le texte.

Renvois

Boolean

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

isUnderline()

Renvoie true si le texte est souligné, false si ce n'est pas le cas ou null s'il existe plusieurs styles dans le texte.

Renvois

Boolean

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

Supprime un Link.

Si vous supprimez un lien, la couleur de premier plan du lien hypertexte et le style de soulignement du texte sont supprimés. Si possible, ces styles sont appliqués pour correspondre au texte précédant le lien. 

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

Renvois

TextStyle

setBackgroundColor(color)

Définit la couleur d'arrière-plan du texte.

Paramètres

NomTypeDescription
colorColor

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setBackgroundColor(red, green, blue)

Définit la couleur d'arrière-plan du texte sur les valeurs RVB données, comprises entre 0 et 255.

Paramètres

NomTypeDescription
redInteger
greenInteger
blueInteger

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setBackgroundColor(hexColor)

Définit la couleur d'arrière-plan du texte sur la chaîne de couleur hexadécimale donnée.

La chaîne hexadécimale doit être au format "#RRGGBB". Par exemple, le rose est représenté par le code "#FFC0CB".

Paramètres

NomTypeDescription
hexColorString

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setBackgroundColor(color)

Définit la couleur d'arrière-plan du texte sur l'ThemeColorType donnée.

Paramètres

NomTypeDescription
colorThemeColorType

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setBackgroundColorTransparent()

Définit la couleur d'arrière-plan du texte sur transparent.

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setBaselineOffset(offset)

Définit le décalage vertical du texte par rapport à sa position normale.

Paramètres

NomTypeDescription
offsetTextBaselineOffset

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setBold(bold)

Indique si le texte doit être affiché en gras.

Modifier la mise en gras du texte met à jour l'épaisseur de la police utilisée pour le rendre.

Paramètres

NomTypeDescription
boldBoolean

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setFontFamily(fontFamily)

Définit la famille de polices du texte .

Paramètres

NomTypeDescription
fontFamilyString

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setFontFamilyAndWeight(fontFamily, fontWeight)

Définit la famille de polices et l'épaisseur du texte.

La pondération est un multiple de 100 compris entre 100 et 900 inclus. Cette plage correspond aux valeurs numériques décrites dans la spécification CSS 2.1, section 15.6, les valeurs non numériques n'étant pas autorisées. Les poids supérieurs ou égaux à 700 sont considérés comme en gras, auquel cas isBold() renvoie true. La valeur par défaut est 400 (valeur "normal").

Paramètres

NomTypeDescription
fontFamilyString
fontWeightInteger

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setFontSize(fontSize)

Définit la taille de police du texte, en points.

Paramètres

NomTypeDescription
fontSizeNumber

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setForegroundColor(foregroundColor)

Définit la couleur de premier plan du texte.

Paramètres

NomTypeDescription
foregroundColorColor

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setForegroundColor(red, green, blue)

Définit la couleur de premier plan du texte sur les valeurs RVB données, comprises entre 0 et 255.

Paramètres

NomTypeDescription
redInteger
greenInteger
blueInteger

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setForegroundColor(hexColor)

Définit la couleur de premier plan du texte sur la chaîne de couleur hexadécimale donnée.

La chaîne hexadécimale doit être au format "#RRGGBB". Par exemple, le rose est représenté par le code "#FFC0CB".

Paramètres

NomTypeDescription
hexColorString

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setForegroundColor(color)

Définit la couleur de premier plan du texte sur l'ThemeColorType donnée.

Paramètres

NomTypeDescription
colorThemeColorType

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setItalic(italic)

Indique si le texte est en italique.

Paramètres

NomTypeDescription
italicBoolean

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLinkSlide(slideIndex)

Définit un Link sur l'Slide donné à l'aide de l'indice de la diapositive basé sur zéro.

Le fait de définir un lien modifie le style du texte, qui est alors souligné et affiche une couleur de premier plan ThemeColorType.HYPERLINK. Vous pouvez modifier ce paramètre via setForegroundColor(hexColor) et setUnderline(underline).

Étant donné qu'il est impossible de définir des liens sur des caractères de nouvelle ligne, les caractères de nouvelle ligne dans TextRange sont ignorés. 

// 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);

Paramètres

NomTypeDescription
slideIndexIntegerIndex basé sur zéro de la diapositive.

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLinkSlide(slide)

Définit un Link sur l'Slide donné. Le lien est défini par l'ID de diapositive donné.

Le fait de définir un lien modifie le style du texte, qui est alors souligné et affiche une couleur de premier plan ThemeColorType.HYPERLINK. Vous pouvez modifier ce paramètre via setForegroundColor(hexColor) et setUnderline(underline).

Étant donné qu'il est impossible de définir des liens sur des caractères de nouvelle ligne, les caractères de nouvelle ligne dans TextRange sont ignorés. 

// 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);

Paramètres

NomTypeDescription
slideSlideSlide à associer.

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLinkSlide(slidePosition)

Définit un Link sur l'Slide donné à l'aide de la position relative de la diapositive.

Le fait de définir un lien modifie le style du texte, qui est alors souligné et affiche une couleur de premier plan ThemeColorType.HYPERLINK. Vous pouvez modifier ce paramètre via setForegroundColor(hexColor) et setUnderline(underline).

Étant donné qu'il est impossible de définir des liens sur des caractères de nouvelle ligne, les caractères de nouvelle ligne dans TextRange sont ignorés. 

// 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);

Paramètres

NomTypeDescription
slidePositionSlidePositionSlidePosition relatif.

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLinkUrl(url)

Définit un Link sur la chaîne d'URL non vide donnée.

Le fait de définir un lien modifie le style du texte, qui est alors souligné et affiche une couleur de premier plan ThemeColorType.HYPERLINK. Vous pouvez modifier ce paramètre via setForegroundColor(hexColor) et setUnderline(underline).

Étant donné qu'il est impossible de définir des liens sur des caractères de nouvelle ligne, les caractères de nouvelle ligne dans TextRange sont ignorés. 

// Set a link to the URL.
const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.getTextStyle().setLinkUrl('https://slides.google.com');

Paramètres

NomTypeDescription
urlStringChaîne d'URL.

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setSmallCaps(smallCaps)

Indique si le texte est affiché en petites majuscules.

Paramètres

NomTypeDescription
smallCapsBoolean

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setStrikethrough(strikethrough)

Indique si le texte est barré.

Paramètres

NomTypeDescription
strikethroughBoolean

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setUnderline(underline)

Indique si le texte est souligné.

Paramètres

NomTypeDescription
underlineBoolean

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations