Class TextStyle

TextStyle

Style du texte

Les méthodes de lecture de cette classe renvoient null si les segments TextRange correspondants plusieurs exécutions de texte, qui ont des valeurs différentes pour la méthode de lecture appelée. À évitez cela, interrogez les styles de texte à l'aide des TextRange renvoyés par la méthode TextRange.getRuns().

Si vous utilisez des méthodes permettant de modifier l'ajustement du texte dans une forme, les paramètres d'ajustement automatique appliqués à la les styles de texte sont désactivés.

Méthodes

MéthodeType renvoyéBrève description
getBackgroundColor()ColorRenvoie la couleur d'arrière-plan du texte, ou null s'il existe plusieurs styles sur la texte.
getBaselineOffset()TextBaselineOffsetRenvoie le décalage vertical du texte par rapport à sa position normale, ou null s'il existe plusieurs styles sur le texte.
getFontFamily()StringRenvoie la famille de polices du texte, ou null s'il existe plusieurs styles sur le texte.
getFontSize()NumberRenvoie la taille de police du texte en points, ou null si plusieurs styles sont appliqués. le texte.
getFontWeight()IntegerRenvoie l'épaisseur de la police du texte, ou null s'il existe plusieurs styles sur le texte.
getForegroundColor()ColorRenvoie la couleur de premier plan du texte, ou null s'il existe plusieurs styles sur la texte.
getLink()LinkRenvoie Link sur le texte, ou null s'il n'y a pas de lien ou si le lien est activé ou s'il y a plusieurs liens.
hasLink()BooleanRenvoie true s'il y a un lien dans le texte, false dans le cas contraire ou null si le le lien se trouve sur une partie du texte ou contient plusieurs liens.
isBackgroundTransparent()BooleanRenvoie true si l'arrière-plan du texte est transparent, false dans le cas contraire, ou null si le texte comporte plusieurs styles.
isBold()BooleanRenvoie true si le texte est affiché en gras, false dans le cas contraire ou null si ce n'est pas le cas. le texte comporte plusieurs styles.
isItalic()BooleanRenvoie true si le texte est en italique, false dans le cas contraire ou null s'il y a plusieurs styles sur le texte.
isSmallCaps()BooleanRenvoie true si le texte est en petites majuscules, false dans le cas contraire, ou null s'il existe plusieurs styles sur le texte.
isStrikethrough()BooleanRenvoie true si le texte est barré, false dans le cas contraire ou null dans le cas contraire. le texte comporte plusieurs styles.
isUnderline()BooleanAffiche true si le texte est souligné, false dans le cas contraire ou null s'il y en a plusieurs styles sur le texte.
removeLink()TextStyleSupprime un élément 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 des valeurs RVB 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 indiquée.
setBackgroundColor(color)TextStyleDéfinit la couleur d'arrière-plan du texte sur la 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)TextStyleDétermine 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 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 des valeurs RVB comprises entre 0 et 255.
setForegroundColor(hexColor)TextStyleDéfinit la couleur de premier plan du texte sur la chaîne de couleur hexadécimale indiquée.
setForegroundColor(color)TextStyleDéfinit la couleur de premier plan du texte sur la ThemeColorType donnée.
setItalic(italic)TextStyleDéfinit si le texte doit être mis en italique ou non.
setLinkSlide(slideIndex)TextStyleDéfinit un Link sur la Slide donnée à l'aide de l'index de 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 la 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 fournie.
setSmallCaps(smallCaps)TextStyleDétermine si le texte s'affiche en petites majuscules.
setStrikethrough(strikethrough)TextStyleDétermine si le texte doit être barré.
setUnderline(underline)TextStyleDétermine si le texte est souligné.

Documentation détaillée

getBackgroundColor()

Renvoie la couleur d'arrière-plan du texte, ou null s'il existe plusieurs styles sur la texte.

Renvois

Color

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 sur le texte.

Renvois

TextBaselineOffset

Autorisation

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

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

getFontFamily()

Renvoie la famille de polices du texte, ou null s'il existe plusieurs styles sur le texte.

Renvois

String

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 police du texte en points, ou null si plusieurs styles sont appliqués. le texte.

Renvois

Number

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 la police du texte, ou null s'il existe plusieurs styles sur le texte.

La pondération est un multiple de 100 compris entre 100 et 900 inclus. Cette plage correspond à les valeurs numériques décrites dans la section 15.6 de la spécification CSS 2.1, avec Les valeurs non numériques ne sont pas autorisées. Les pondérations supérieures ou égales à 700 sont considérées comme des caractères gras, au format auquel cas isBold() renvoie true. La valeur par défaut est 400 ("normal").

Renvois

Integer

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application 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 s'il existe plusieurs styles sur la texte.

Renvois

Color

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application 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 ou si le lien est activé ou s'il y a plusieurs liens. Appelez hasLink() pour déterminer si le texte ne contient pas de lien. 

var 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 correspondant à 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 dans le cas contraire ou null si le Le lien se trouve dans une partie du texte ou comporte plusieurs liens.

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

Renvois

Boolean

Autorisation

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

Renvois

Boolean

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 dans le cas contraire, ou null si ce n'est pas le cas. le texte comporte plusieurs styles.

Renvois

Boolean

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 dans le cas contraire ou null s'il y a plusieurs styles sur le texte.

Renvois

Boolean

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 sur le texte.

Renvois

Boolean

Autorisation

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

Renvois

Boolean

Autorisation

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

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

isUnderline()

Affiche true si le texte est souligné, false dans le cas contraire ou null s'il y en a plusieurs styles sur le texte.

Renvois

Boolean

Autorisation

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

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

Supprime un élément Link.

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

text.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 correspondant à 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 indiquées (entre 0 et 255).

Paramètres

NomTypeDescription
redInteger
greenInteger
blueInteger

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 indiquée.

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

Paramètres

NomTypeDescription
hexColorString

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 la ThemeColorType donnée.

Paramètres

NomTypeDescription
colorThemeColorType

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 correspondant à 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 correspondant à un ou plusieurs des champs d'application suivants:

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

setBold(bold)

Détermine si le texte doit être affiché en gras.

La modification du caractère gras du texte entraîne la mise à jour de l'épaisseur de police utilisée pour le rendu.

Paramètres

NomTypeDescription
boldBoolean

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 correspondant à 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 à les valeurs numériques décrites dans la section 15.6 de la spécification CSS 2.1, avec Les valeurs non numériques ne sont pas autorisées. Les pondérations supérieures ou égales à 700 sont considérées comme des caractères gras, au format 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 correspondant à 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 la police du texte, en points.

Paramètres

NomTypeDescription
fontSizeNumber

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 correspondant à 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 des valeurs RVB 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 correspondant à 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 indiquée.

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

Paramètres

NomTypeDescription
hexColorString

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 la ThemeColorType donnée.

Paramètres

NomTypeDescription
colorThemeColorType

Renvois

TextStyle

Autorisation

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

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

setItalic(italic)

Définit si le texte doit être mis en italique ou non.

Paramètres

NomTypeDescription
italicBoolean

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 la Slide donnée à l'aide de l'index de base zéro de la diapositive.

Définir un lien modifie le style du texte pour qu'il soit souligné et qu'il ait 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 des caractères de nouvelle ligne, ceux-ci dans TextRange sont ignorés. 

// Set a link to the first slide of the presentation.
text.getTextStyle().setLinkSlide(0);

Paramètres

NomTypeDescription
slideIndexIntegerL'indice basé sur zéro à la diapositive.

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 le Slide donné, le lien est défini par l'ID de la diapositive donné.

Définir un lien modifie le style du texte pour qu'il soit souligné et qu'il ait 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 des caractères de nouvelle ligne, ceux-ci dans TextRange sont ignorés. 

// Set a link to the first slide of the presentation.
var slide = presentation.getSlides()[0];
text.getTextStyle().setLinkSlide(slide);

Paramètres

NomTypeDescription
slideSlideSlide à associer.

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 le Slide donné en utilisant la position relative de la diapositive.

Définir un lien modifie le style du texte pour qu'il soit souligné et qu'il ait 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 des caractères de nouvelle ligne, ceux-ci dans TextRange sont ignorés. 

// Set a link to the first slide of the presentation.
text.getTextStyle().setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

Paramètres

NomTypeDescription
slidePositionSlidePositionLa valeur SlidePosition relative.

Renvois

TextStyle

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 fournie.

Définir un lien modifie le style du texte pour qu'il soit souligné et qu'il ait 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 des caractères de nouvelle ligne, ceux-ci dans TextRange sont ignorés. 

// Set a link to the URL.
text.getTextStyle().setLinkUrl("https://slides.google.com");

Paramètres

NomTypeDescription
urlStringChaîne de l'URL.

Renvois

TextStyle

Autorisation

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

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

setSmallCaps(smallCaps)

Détermine si le texte s'affiche en petites majuscules.

Paramètres

NomTypeDescription
smallCapsBoolean

Renvois

TextStyle

Autorisation

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

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

setStrikethrough(strikethrough)

Détermine si le texte doit être barré.

Paramètres

NomTypeDescription
strikethroughBoolean

Renvois

TextStyle

Autorisation

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

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

setUnderline(underline)

Détermine si le texte est souligné.

Paramètres

NomTypeDescription
underlineBoolean

Renvois

TextStyle

Autorisation

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

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