Class TextStyle

TexteStyle

Style du texte.

Les méthodes de lecture de cette classe renvoient null si les étendues TextRange correspondantes couvrent plusieurs séries de texte et que ces séries 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 la façon dont le texte s'insère 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()Color|nullRenvoie la couleur d'arrière-plan du texte ou null si le texte comporte plusieurs styles.
getBaselineOffset()TextBaselineOffset|nullRenvoie le décalage vertical du texte par rapport à sa position normale, ou null si le texte comporte plusieurs styles.
getFontFamily()String|nullRenvoie la famille de police du texte ou null si le texte comporte plusieurs styles.
getFontSize()Number|nullRenvoie la taille de police du texte en points ou null si le texte comporte plusieurs styles.
getFontWeight()Integer|nullRenvoie l'épaisseur de la police du texte ou null si le texte comporte plusieurs styles.
getForegroundColor()Color|nullRenvoie la couleur de premier plan du texte ou null si le texte comporte plusieurs styles.
getLink()Link|nullRenvoie Link sur le texte ou null s'il n'y a pas de lien, si le lien se trouve sur une partie du texte ou s'il y a plusieurs liens.
hasLink()Boolean|nullRenvoie true si le texte contient un lien, false dans le cas contraire ou null si le lien se trouve sur une partie du texte ou s'il y a plusieurs liens.
isBackgroundTransparent()Boolean|nullRenvoie true si l'arrière-plan du texte est transparent, false dans le cas contraire ou null si le texte comporte plusieurs styles.
isBold()Boolean|nullRenvoie true si le texte est mis en gras, false dans le cas contraire ou null si le texte comporte plusieurs styles.
isItalic()Boolean|nullRenvoie true si le texte est en italique, false dans le cas contraire ou null si le texte comporte plusieurs styles.
isSmallCaps()Boolean|nullRenvoie true si le texte est en petites majuscules, false dans le cas contraire ou null si le texte comporte plusieurs styles.
isStrikethrough()Boolean|nullRenvoie true si le texte est barré, false dans le cas contraire ou null si le texte comporte plusieurs styles.
isUnderline()Boolean|nullRenvoie true si le texte est souligné, false dans le cas contraire ou null si le texte comporte plusieurs styles.
removeLink()TextStyleSupprime une 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 (de 0 à 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 la valeur ThemeColorType spécifié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 et l'épaisseur de la police du texte.
setFontSize(fontSize)TextStyleDéfinit la taille de la 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 (de 0 à 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 la valeur ThemeColorType donnée.
setItalic(italic)TextStyleIndique si le texte est en italique.
setLinkSlide(slideIndex)TextStyleDéfinit un Link sur le Slide donné à l'aide de l'index base zéro de la diapositive.
setLinkSlide(slide)TextStyleDéfinit un Link sur le Slide donné. Le lien est défini par l'ID de diapositive donné.
setLinkSlide(slidePosition)TextStyleDéfinit un Link sur le Slide donné en utilisant 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()

Renvoie la couleur d'arrière-plan du texte ou null si le texte comporte plusieurs styles.

Renvois

Color|null

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 si le texte comporte plusieurs styles.

Renvois

TextBaselineOffset|null

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getFontFamily()

Renvoie la famille de police du texte ou null si le texte comporte plusieurs styles.

Renvois

String|null

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getFontSize()

Renvoie la taille de police du texte en points ou null si le texte comporte plusieurs styles.

Renvois

Number|null

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getFontWeight()

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

La valeur de la pondération doit être 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, avec les valeurs non numériques interdites. Les valeurs de poids supérieures ou égales à 700 sont considérées comme étant en gras, auquel cas isBold() renvoie true. La valeur par défaut est 400 ("normal").

Renvois

Integer|null

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getForegroundColor()

Renvoie la couleur de premier plan du texte ou null si le texte comporte plusieurs styles.

Renvois

Color|null

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

Renvoie Link sur le texte ou null s'il n'y a pas de lien, si le lien se trouve sur 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|null

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

Renvoie true si le texte contient un lien, false dans le cas contraire ou null si le lien se trouve sur une partie du texte ou s'il y a plusieurs liens.

Il est impossible de définir des liens 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|null

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 dans le cas contraire ou null si le texte comporte plusieurs styles.

Renvois

Boolean|null

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

isBold()

Renvoie true si le texte est mis en gras, false dans le cas contraire ou null si le texte comporte plusieurs styles.

Renvois

Boolean|null

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

isItalic()

Renvoie true si le texte est en italique, false dans le cas contraire ou null si le texte comporte plusieurs styles.

Renvois

Boolean|null

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 si le texte comporte plusieurs styles.

Renvois

Boolean|null

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

isStrikethrough()

Renvoie true si le texte est barré, false dans le cas contraire ou null si le texte comporte plusieurs styles.

Renvois

Boolean|null

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

isUnderline()

Renvoie true si le texte est souligné, false dans le cas contraire ou null si le texte comporte plusieurs styles.

Renvois

Boolean|null

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

Supprime une Link.

Si vous supprimez un lien, la couleur de premier plan 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 scopes 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 (de 0 à 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 scopes 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 serait représenté par "#FFC0CB".

Paramètres

NomTypeDescription
hexColorString

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 la valeur ThemeColorType spécifiée.

Paramètres

NomTypeDescription
colorThemeColorType

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 scopes 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 scopes 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.

Si vous mettez le texte en gras, le poids de la police utilisée pour le rendu du texte est modifié.

Paramètres

NomTypeDescription
boldBoolean

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 scopes suivants :

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

setFontFamilyAndWeight(fontFamily, fontWeight)

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

La valeur de la pondération doit être 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, avec les valeurs non numériques interdites. Les valeurs de poids supérieures ou égales à 700 sont considérées comme étant en gras, auquel cas isBold() renvoie true. La valeur par défaut est 400 ("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 scopes suivants :

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

setFontSize(fontSize)

Définit la taille de la 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 scopes 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 scopes 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 (de 0 à 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 scopes 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 serait représenté par "#FFC0CB".

Paramètres

NomTypeDescription
hexColorString

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 la valeur 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 scopes 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 scopes suivants :

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

setLinkSlide(slideIndex)

Définit un Link sur le Slide donné à l'aide de l'index base zéro de la diapositive.

Définir un lien modifie le style du texte en le soulignant et en lui attribuant une couleur de premier plan ThemeColorType.HYPERLINK. Vous pouvez modifier ce paramètre via setForegroundColor(hexColor) et setUnderline(underline).

Étant donné que les liens ne peuvent pas être définis sur les caractères de nouvelle ligne, ceux-ci sont ignorés dans TextRange. 

// 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 scopes suivants :

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

setLinkSlide(slide)

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

Définir un lien modifie le style du texte en le soulignant et en lui attribuant une couleur de premier plan ThemeColorType.HYPERLINK. Vous pouvez modifier ce paramètre via setForegroundColor(hexColor) et setUnderline(underline).

Étant donné que les liens ne peuvent pas être définis sur les caractères de nouvelle ligne, ceux-ci sont ignorés dans TextRange. 

// 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 scopes suivants :

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

setLinkSlide(slidePosition)

Définit un Link sur le Slide donné en utilisant la position relative de la diapositive.

Définir un lien modifie le style du texte en le soulignant et en lui attribuant une couleur de premier plan ThemeColorType.HYPERLINK. Vous pouvez modifier ce paramètre via setForegroundColor(hexColor) et setUnderline(underline).

Étant donné que les liens ne peuvent pas être définis sur les caractères de nouvelle ligne, ceux-ci sont ignorés dans TextRange. 

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

Définir un lien modifie le style du texte en le soulignant et en lui attribuant une couleur de premier plan ThemeColorType.HYPERLINK. Vous pouvez modifier ce paramètre via setForegroundColor(hexColor) et setUnderline(underline).

Étant donné que les liens ne peuvent pas être définis sur les caractères de nouvelle ligne, ceux-ci sont ignorés dans TextRange. 

// 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 scopes 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 scopes 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 scopes 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 scopes suivants :

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