Style du texte
Les méthodes de lecture de cette classe renvoient null
si le TextRange
correspondant couvre plusieurs exécutions de texte, et 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 la façon dont le texte s'adapte à une forme, tous les paramètres d'ajustement automatique appliqués aux styles de texte sont désactivés.
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
getBackgroundColor() | Color | Renvoie la couleur d'arrière-plan du texte, ou null si le texte comporte plusieurs styles. |
getBaselineOffset() | TextBaselineOffset | Renvoie le décalage vertical du texte par rapport à sa position normale, ou null si le texte comporte plusieurs styles. |
getFontFamily() | String | Renvoie la famille de polices du texte, ou null si le texte comporte plusieurs styles. |
getFontSize() | Number | Renvoie la taille de police du texte en points, ou null si le texte comporte plusieurs styles. |
getFontWeight() | Integer | Renvoie l'épaisseur de police du texte, ou null si le texte comporte plusieurs styles. |
getForegroundColor() | Color | Renvoie la couleur de premier plan du texte, ou null si le texte présente plusieurs styles. |
getLink() | Link | Renvoie le Link au niveau du texte, ou null s'il n'y a pas de lien, s'il fait partie du texte ou s'il existe plusieurs liens. |
hasLink() | Boolean | Renvoie true si le texte contient un lien, false dans le cas contraire, ou null si le lien se trouve dans le texte ou s'il existe plusieurs liens. |
isBackgroundTransparent() | Boolean | Renvoie true si l'arrière-plan du texte est transparent, false dans le cas contraire ou null si le texte présente plusieurs styles. |
isBold() | Boolean | Renvoie true si le texte s'affiche en gras, false dans le cas contraire ou null s'il existe plusieurs styles. |
isItalic() | Boolean | Renvoie true si le texte est en italique, false dans le cas contraire ou null s'il existe plusieurs styles. |
isSmallCaps() | Boolean | Renvoie true si le texte est en petites majuscules, false dans le cas contraire ou null s'il comporte plusieurs styles. |
isStrikethrough() | Boolean | Renvoie true si le texte est barré, false dans le cas contraire ou null s'il existe plusieurs styles. |
isUnderline() | Boolean | Renvoie true si le texte est souligné, false dans le cas contraire ou null s'il existe plusieurs styles. |
removeLink() | TextStyle | Supprime un Link . |
setBackgroundColor(color) | TextStyle | Définit la couleur d'arrière-plan du texte. |
setBackgroundColor(red, green, blue) | TextStyle | Définit la couleur d'arrière-plan du texte sur les valeurs RVB données comprises entre 0 et 255. |
setBackgroundColor(hexColor) | TextStyle | Définit la couleur d'arrière-plan du texte sur la chaîne de couleur hexadécimale donnée. |
setBackgroundColor(color) | TextStyle | Définit la couleur d'arrière-plan du texte sur le ThemeColorType donné. |
setBackgroundColorTransparent() | TextStyle | Définit la couleur d'arrière-plan du texte comme transparente. |
setBaselineOffset(offset) | TextStyle | Définit le décalage vertical du texte par rapport à sa position normale. |
setBold(bold) | TextStyle | Détermine si le texte doit être affiché en gras. |
setFontFamily(fontFamily) | TextStyle | Définit la famille de polices du texte . |
setFontFamilyAndWeight(fontFamily, fontWeight) | TextStyle | Définit la famille de polices et l'épaisseur du texte. |
setFontSize(fontSize) | TextStyle | Définit la taille de police du texte, en points. |
setForegroundColor(foregroundColor) | TextStyle | Définit la couleur du premier plan du texte. |
setForegroundColor(red, green, blue) | TextStyle | Définit la couleur de premier plan du texte sur les valeurs RVB données comprises entre 0 et 255. |
setForegroundColor(hexColor) | TextStyle | Définit la couleur de premier plan du texte sur la chaîne de couleurs hexadécimale donnée. |
setForegroundColor(color) | TextStyle | Définit la couleur de premier plan du texte sur la valeur ThemeColorType donnée. |
setItalic(italic) | TextStyle | Définit si le texte est mis en italique. |
setLinkSlide(slideIndex) | TextStyle | Définit un Link sur le Slide donné à l'aide de l'index basé sur zéro de la diapositive. |
setLinkSlide(slide) | TextStyle | Définit un Link sur le Slide donné, le lien est défini par l'ID de diapositive indiqué. |
setLinkSlide(slidePosition) | TextStyle | Définit un Link sur le Slide donné en utilisant la position relative de la diapositive. |
setLinkUrl(url) | TextStyle | Définit un Link sur la chaîne d'URL non vide donnée. |
setSmallCaps(smallCaps) | TextStyle | Détermine si le texte s'affiche en petites majuscules. |
setStrikethrough(strikethrough) | TextStyle | Détermine si le texte est rayé. |
setUnderline(underline) | TextStyle | Détermine 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
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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
si le texte comporte plusieurs styles.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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
si le texte comporte plusieurs styles.
Renvois
String
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 le texte comporte plusieurs styles.
Renvois
Number
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 section 15.6 de la spécification CSS 2.1, et les valeurs non numériques ne sont pas autorisées. Les pondérations supérieures ou égales à 700 sont considérées en gras, 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 associée à 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
si le texte présente plusieurs styles.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLink()
Renvoie le Link
au niveau du texte, ou null
s'il n'y a pas de lien, s'il fait partie du texte ou s'il existe plusieurs liens. Appelez hasLink()
pour déterminer si le texte ne comporte pas de lien.
var textLink = shape.getText().getTextStyle().getLink(); if (textLink != null) { Logger.log('Shape text has a link of type: ' + textLink.getLinkType()); }
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
hasLink()
Renvoie true
si le texte contient un lien, false
dans le cas contraire, ou null
si le lien se trouve dans le texte ou s'il existe 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 caractère 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 associée à 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 présente plusieurs styles.
Renvois
Boolean
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 s'affiche en gras, false
dans le cas contraire ou null
s'il existe plusieurs styles.
Renvois
Boolean
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 existe plusieurs styles.
Renvois
Boolean
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 comporte plusieurs styles.
Renvois
Boolean
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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
s'il existe plusieurs styles.
Renvois
Boolean
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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
dans le cas contraire ou null
s'il existe plusieurs styles.
Renvois
Boolean
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeLink()
setBackgroundColor(color)
Définit la couleur d'arrière-plan du texte.
Paramètres
Nom | Type | Description |
---|---|---|
color | Color |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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
Nom | Type | Description |
---|---|---|
red | Integer | |
green | Integer | |
blue | Integer |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 "#FFC0CB".
Paramètres
Nom | Type | Description |
---|---|---|
hexColor | String |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 le ThemeColorType
donné.
Paramètres
Nom | Type | Description |
---|---|---|
color | ThemeColorType |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 comme transparente.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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
Nom | Type | Description |
---|---|---|
offset | TextBaselineOffset |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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.
Si vous modifiez la mise en gras du texte, l'épaisseur de la police utilisée pour le rendu est mise à jour.
Paramètres
Nom | Type | Description |
---|---|---|
bold | Boolean |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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
Nom | Type | Description |
---|---|---|
fontFamily | String |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 section 15.6 de la spécification CSS 2.1, et les valeurs non numériques ne sont pas autorisées. Les pondérations supérieures ou égales à 700 sont considérées en gras, auquel cas isBold()
renvoie true
. La valeur par défaut est 400 ("normal").
Paramètres
Nom | Type | Description |
---|---|---|
fontFamily | String | |
fontWeight | Integer |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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
Nom | Type | Description |
---|---|---|
fontSize | Number |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 du premier plan du texte.
Paramètres
Nom | Type | Description |
---|---|---|
foregroundColor | Color |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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
Nom | Type | Description |
---|---|---|
red | Integer | |
green | Integer | |
blue | Integer |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 couleurs hexadécimale donnée.
La chaîne hexadécimale doit être au format "#RRGGBB". Par exemple, le rose est représenté par "#FFC0CB".
Paramètres
Nom | Type | Description |
---|---|---|
hexColor | String |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 valeur ThemeColorType
donnée.
Paramètres
Nom | Type | Description |
---|---|---|
color | ThemeColorType |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 est mis en italique.
Paramètres
Nom | Type | Description |
---|---|---|
italic | Boolean |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 le Slide
donné à l'aide de l'index basé sur zéro de la diapositive.
En définissant un lien, vous modifiez le style du texte qui est souligné et dont la couleur de premier plan est ThemeColorType.HYPERLINK
. Ce paramètre peut être modifié via setForegroundColor(hexColor)
et setUnderline(underline)
.
Étant donné que les liens ne peuvent pas être définis sur des caractères de retour à la ligne, les caractères de retour à la ligne dans TextRange
sont ignorés.
// Set a link to the first slide of the presentation. text.getTextStyle().setLinkSlide(0);
Paramètres
Nom | Type | Description |
---|---|---|
slideIndex | Integer | Indice basé sur zéro de la diapositive. |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 diapositive indiqué.
En définissant un lien, vous modifiez le style du texte qui est souligné et dont la couleur de premier plan est ThemeColorType.HYPERLINK
. Ce paramètre peut être modifié via setForegroundColor(hexColor)
et setUnderline(underline)
.
Étant donné que les liens ne peuvent pas être définis sur des caractères de retour à la ligne, les caractères de retour à la ligne 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
Nom | Type | Description |
---|---|---|
slide | Slide | Le Slide à associer. |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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.
En définissant un lien, vous modifiez le style du texte qui est souligné et dont la couleur de premier plan est ThemeColorType.HYPERLINK
. Ce paramètre peut être modifié via setForegroundColor(hexColor)
et setUnderline(underline)
.
Étant donné que les liens ne peuvent pas être définis sur des caractères de retour à la ligne, les caractères de retour à la ligne dans TextRange
sont ignorés.
// Set a link to the first slide of the presentation. text.getTextStyle().setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);
Paramètres
Nom | Type | Description |
---|---|---|
slidePosition | SlidePosition | La valeur SlidePosition relative. |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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.
En définissant un lien, vous modifiez le style du texte qui est souligné et dont la couleur de premier plan est ThemeColorType.HYPERLINK
. Ce paramètre peut être modifié via setForegroundColor(hexColor)
et setUnderline(underline)
.
Étant donné que les liens ne peuvent pas être définis sur des caractères de retour à la ligne, les caractères de retour à la ligne dans TextRange
sont ignorés.
// Set a link to the URL. text.getTextStyle().setLinkUrl("https://slides.google.com");
Paramètres
Nom | Type | Description |
---|---|---|
url | String | Chaîne d'URL. |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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
Nom | Type | Description |
---|---|---|
smallCaps | Boolean |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 est rayé.
Paramètres
Nom | Type | Description |
---|---|---|
strikethrough | Boolean |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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
Nom | Type | Description |
---|---|---|
underline | Boolean |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations