Style du texte.
Les méthodes de lecture de cette classe renvoient null si les étendues Text 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 Text renvoyés par la méthode Text.
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éthode | Type renvoyé | Brève description |
|---|---|---|
get | Color|null | Renvoie la couleur d'arrière-plan du texte ou null si le texte comporte plusieurs styles. |
get | Text | Renvoie le décalage vertical du texte par rapport à sa position normale, ou null si le texte comporte plusieurs styles. |
get | String|null | Renvoie la famille de police du texte ou null si le texte comporte plusieurs styles. |
get | Number|null | Renvoie la taille de police du texte en points ou null si le texte comporte plusieurs styles. |
get | Integer|null | Renvoie l'épaisseur de la police du texte ou null si le texte comporte plusieurs styles. |
get | Color|null | Renvoie la couleur de premier plan du texte ou null si le texte comporte plusieurs styles. |
get | Link|null | 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. |
has | Boolean|null | 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. |
is | Boolean|null | Renvoie true si l'arrière-plan du texte est transparent, false dans le cas contraire ou null si le texte comporte plusieurs styles. |
is | Boolean|null | Renvoie true si le texte est affiché en gras, false dans le cas contraire ou null si le texte comporte plusieurs styles. |
is | Boolean|null | Renvoie true si le texte est en italique, false dans le cas contraire ou null si le texte comporte plusieurs styles. |
is | Boolean|null | Renvoie true si le texte est en petites majuscules, false dans le cas contraire ou null si le texte comporte plusieurs styles. |
is | Boolean|null | Renvoie true si le texte est barré, false dans le cas contraire ou null si le texte comporte plusieurs styles. |
is | Boolean|null | Renvoie true si le texte est souligné, false dans le cas contraire ou null si le texte comporte plusieurs styles. |
remove | Text | Supprime une Link. |
set | Text | Définit la couleur d'arrière-plan du texte. |
set | Text | Définit la couleur d'arrière-plan du texte sur les valeurs RVB données (de 0 à 255). |
set | Text | Définit la couleur d'arrière-plan du texte sur la chaîne de couleur hexadécimale donnée. |
set | Text | Définit la couleur d'arrière-plan du texte sur la valeur Theme spécifiée. |
set | Text | Définit la couleur d'arrière-plan du texte sur transparent. |
set | Text | Définit le décalage vertical du texte par rapport à sa position normale. |
set | Text | Indique si le texte doit être affiché en gras. |
set | Text | Définit la famille de polices du texte . |
set | Text | Définit la famille et l'épaisseur de la police du texte. |
set | Text | Définit la taille de la police du texte, en points. |
set | Text | Définit la couleur de premier plan du texte. |
set | Text | Définit la couleur de premier plan du texte sur les valeurs RVB données (de 0 à 255). |
set | Text | Définit la couleur de premier plan du texte sur la chaîne de couleur hexadécimale donnée. |
set | Text | Définit la couleur de premier plan du texte sur la valeur Theme donnée. |
set | Text | Indique si le texte est en italique. |
set | Text | Définit un Link sur le Slide donné à l'aide de l'index base zéro de la diapositive. |
set | Text | Définit un Link sur le Slide donné. Le lien est défini par l'ID de diapositive donné. |
set | Text | Définit un Link sur le Slide donné en utilisant la position relative de la diapositive. |
set | Text | Définit un Link sur la chaîne d'URL non vide donnée. |
set | Text | Indique si le texte est affiché en petites majuscules. |
set | Text | Indique si le texte est barré. |
set | Text | Indique si le texte est souligné. |
Documentation détaillée
get
Renvoie la couleur d'arrière-plan du texte ou null si le texte comporte plusieurs styles.
Renvois
Color|null : couleur d'arrière-plan du texte.
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
get
Renvoie le décalage vertical du texte par rapport à sa position normale, ou null si le texte comporte plusieurs styles.
Renvois
Text : décalage vertical du texte par rapport à sa position normale.
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
get
Renvoie la famille de police du texte ou null si le texte comporte plusieurs styles.
Renvois
String|null : famille de polices du texte.
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
get
Renvoie la taille de police du texte en points ou null si le texte comporte plusieurs styles.
Renvois
Number|null : taille de la police du texte en points.
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
get
Renvoie l'épaisseur de la 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, 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 is renvoie true. La valeur par défaut est 400 ("normal").
Renvois
Integer|null : épaisseur de la police du texte.
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
get
Renvoie la couleur de premier plan du texte ou null si le texte comporte plusieurs styles.
Renvois
Color|null : couleur de premier plan du texte.
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
get
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 has 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 : lien vers le texte.
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
has
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 Text contient un caractère de nouvelle ligne, cette méthode renvoie toujours null ou false.
Renvois
Boolean|null : indique si le texte contient un lien.
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
is
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 : indique si l'arrière-plan du texte est transparent.
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
is
Renvoie true si le texte est affiché en gras, false dans le cas contraire ou null si le texte comporte plusieurs styles.
Renvois
Boolean|null : indique si le texte est mis en gras.
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
is
Renvoie true si le texte est en italique, false dans le cas contraire ou null si le texte comporte plusieurs styles.
Renvois
Boolean|null : indique si le texte est en italique.
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
is
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 : indique si le texte est en petites capitales.
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
is
Renvoie true si le texte est barré, false dans le cas contraire ou null si le texte comporte plusieurs styles.
Renvois
Boolean|null : indique si le texte est barré.
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
is
Renvoie true si le texte est souligné, false dans le cas contraire ou null si le texte comporte plusieurs styles.
Renvois
Boolean|null : indique si le texte est souligné.
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
remove
Supprime une Link.
Si vous supprimez un lien, la couleur de premier plan et le style de soulignement du texte du lien hypertexte 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
set
Définit la couleur d'arrière-plan du texte.
Paramètres
| Nom | Type | Description |
|---|---|---|
color | Color | Couleur d'arrière-plan à définir. |
Renvois
Text : ce Text, pour le chaînage.
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
set
Définit la couleur d'arrière-plan du texte sur les valeurs RVB données (de 0 à 255).
Paramètres
| Nom | Type | Description |
|---|---|---|
red | Integer | Composant rouge de la couleur. |
green | Integer | Composant vert de la couleur. |
blue | Integer | Composant bleu de la couleur. |
Renvois
Text : ce Text, pour le chaînage.
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
set
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
Paramètres
| Nom | Type | Description |
|---|---|---|
hex | String | Chaîne de couleur hexadécimale. |
Renvois
Text : ce Text, pour le chaînage.
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
set
Définit la couleur d'arrière-plan du texte sur la valeur Theme spécifiée.
Paramètres
| Nom | Type | Description |
|---|---|---|
color | Theme | Type de couleur du thème. |
Renvois
Text : ce Text, pour le chaînage.
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
set
Définit la couleur d'arrière-plan du texte sur transparent.
Renvois
Text : ce Text, pour le chaînage.
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
set
Définit le décalage vertical du texte par rapport à sa position normale.
Paramètres
| Nom | Type | Description |
|---|---|---|
offset | Text | Décalage de référence à définir. |
Renvois
Text : ce Text, pour le chaînage.
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
set
Indique si le texte doit être affiché en gras.
Paramètres
| Nom | Type | Description |
|---|---|---|
bold | Boolean | Indique si le texte doit être affiché en gras. |
Renvois
Text : ce Text, pour le chaînage.
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
set
Définit la famille de polices du texte .
Paramètres
| Nom | Type | Description |
|---|---|---|
font | String | Famille de polices à définir. |
Renvois
Text : ce Text, pour le chaînage.
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
set
Définit la famille et l'épaisseur de la police du texte.
Paramètres
| Nom | Type | Description |
|---|---|---|
font | String | Famille de polices. |
font | Integer | Épaisseur de la police. |
Renvois
Text : ce Text, pour le chaînage.
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
set
Définit la taille de la police du texte, en points.
Paramètres
| Nom | Type | Description |
|---|---|---|
font | Number | Taille de la police en points. |
Renvois
Text : ce Text, pour le chaînage.
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
set
Définit la couleur de premier plan du texte.
Paramètres
| Nom | Type | Description |
|---|---|---|
foreground | Color | Couleur de premier plan à définir. |
Renvois
Text : ce Text, pour le chaînage.
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
set
Définit la couleur de premier plan du texte sur les valeurs RVB données (de 0 à 255).
Paramètres
| Nom | Type | Description |
|---|---|---|
red | Integer | Composant rouge de la couleur. |
green | Integer | Composant vert de la couleur. |
blue | Integer | Composant bleu de la couleur. |
Renvois
Text : ce Text, pour le chaînage.
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
set
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
Paramètres
| Nom | Type | Description |
|---|---|---|
hex | String | Chaîne de couleur hexadécimale. |
Renvois
Text : ce Text, pour le chaînage.
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
set
Définit la couleur de premier plan du texte sur la valeur Theme donnée.
Paramètres
| Nom | Type | Description |
|---|---|---|
color | Theme | Type de couleur du thème. |
Renvois
Text : ce Text, pour le chaînage.
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
set
Indique si le texte est en italique.
Paramètres
| Nom | Type | Description |
|---|---|---|
italic | Boolean | Indique si le texte doit être affiché en italique. |
Renvois
Text : ce Text, pour le chaînage.
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
set
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 Theme. Vous pouvez modifier ce paramètre via set et set.
Étant donné que les liens ne peuvent pas être définis sur les caractères de nouvelle ligne, ceux-ci sont ignorés dans Text.
// 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
| Nom | Type | Description |
|---|---|---|
slide | Integer | Index basé sur zéro de la diapositive. |
Renvois
Text : ce Text, pour le chaînage.
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
set
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 Theme. Vous pouvez modifier ce paramètre via set et set.
Étant donné que les liens ne peuvent pas être définis sur les caractères de nouvelle ligne, ceux-ci sont ignorés dans Text.
// 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
| Nom | Type | Description |
|---|---|---|
slide | Slide | Slide à associer. |
Renvois
Text : ce Text, pour le chaînage.
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
set
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 Theme. Vous pouvez modifier ce paramètre via set et set.
Étant donné que les liens ne peuvent pas être définis sur les caractères de nouvelle ligne, ceux-ci sont ignorés dans Text.
// 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
| Nom | Type | Description |
|---|---|---|
slide | Slide | Slide relatif. |
Renvois
Text : ce Text, pour le chaînage.
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
set
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 Theme. Vous pouvez modifier ce paramètre via set et set.
Étant donné que les liens ne peuvent pas être définis sur les caractères de nouvelle ligne, ceux-ci sont ignorés dans Text.
// Set a link to the URL. const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText(); textRange.getTextStyle().setLinkUrl('https://slides.google.com');
Paramètres
| Nom | Type | Description |
|---|---|---|
url | String | Chaîne d'URL. |
Renvois
Text : ce Text, pour le chaînage.
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
set
Indique si le texte est affiché en petites majuscules.
Paramètres
| Nom | Type | Description |
|---|---|---|
small | Boolean | Indique si le texte doit être affiché en petites capitales. |
Renvois
Text : ce Text, pour le chaînage.
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
set
Indique si le texte est barré.
Paramètres
| Nom | Type | Description |
|---|---|---|
strikethrough | Boolean | Indique si le texte doit être barré. |
Renvois
Text : ce Text, pour le chaînage.
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
set
Indique si le texte est souligné.
Paramètres
| Nom | Type | Description |
|---|---|---|
underline | Boolean | Indique si le texte doit être souligné. |
Renvois
Text : ce Text, pour le chaînage.
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