Segment du contenu textuel d'un Shape
ou d'un Table
.
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 à la forme sont désactivés.
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
append | Paragraph | Ajoute un paragraphe à la fin de la plage de texte. |
append | Text | Ajoute une copie de la plage de texte fournie à la fin de la plage de texte actuelle. |
append | Text | Ajoute une copie de la plage de texte fournie à la fin de la plage de texte actuelle. |
append | Text | Ajoute du texte à la fin de la plage de texte. |
as | String | Renvoie le texte affiché délimité par cette plage de la forme ou de la cellule de tableau associée dans un format approprié pour l'affichage aux utilisateurs finaux. |
as | String | Renvoie le texte brut délimité par cette plage de la forme ou de la cellule de tableau associée. |
clear() | void | Efface le texte délimité par cette plage. |
clear(startOffset, endOffset) | void | Efface le texte délimité par les décalages de début et de fin dans la plage. |
find(pattern) | Text | Renvoie toutes les plages correspondant au modèle de recherche dans la plage de texte actuelle. |
find(pattern, startOffset) | Text | Renvoie toutes les plages correspondant au modèle de recherche dans la plage de texte actuelle à partir du décalage de début. |
get | Auto | Renvoie les textes automatiques dans la plage de texte actuelle. |
get | Integer | Renvoie l'index exclusif (à partir de 0) du dernier caractère de cette plage. |
get | Integer | Renvoie le nombre de caractères dans cette plage. |
get | Text | Renvoie une collection de plages de texte qui correspondent à tous les Link dans la plage de texte actuelle ou qui la chevauchent. |
get | Paragraph[] | Renvoie les paragraphes des listes qui chevauchent la plage de texte actuelle. |
get | List | Renvoie le List de la plage de texte actuelle. |
get | Paragraph | Renvoie le Paragraph de la plage de texte actuelle. |
get | Paragraph[] | Renvoie les paragraphes qui chevauchent la plage de texte actuelle. |
get | Text | Renvoie un nouvel Text couvrant une partie de la plage dont il est issu. |
get | Text | Renvoie les séries de texte qui chevauchent la plage de texte actuelle. |
get | Integer | Renvoie l'index inclusif basé sur 0 du premier caractère de cette plage. |
get | Text | Renvoie le style de texte de la plage ou null si la plage est vide. |
insert | Paragraph | Insère un paragraphe au décalage de début. |
insert | Text | Insère une copie de la plage de texte fournie au décalage de début. |
insert | Text | Insère une copie de la plage de texte fournie au décalage de début. |
insert | Text | Insère du texte au décalage de début. |
is | Boolean | Renvoie true si cette plage ne contient aucun caractère et false dans le cas contraire. |
replace | Integer | Remplace toutes les instances du texte à rechercher par le texte de remplacement. |
replace | Integer | Remplace toutes les instances du texte à rechercher par le texte de remplacement. |
select() | void | Sélectionne uniquement le Text dans la présentation active et supprime toute sélection précédente. |
set | Text | Définit le texte délimité par cette plage de la forme ou de la cellule de tableau associée. |
Documentation détaillée
append Paragraph(text)
Ajoute un paragraphe à la fin de la plage de texte. Le paragraphe conserve le style de la fin de la plage de texte actuelle.
La chaîne de texte fournie est ajoutée en tant que paragraphe en ajoutant au moins un caractère de nouvelle ligne autour de la chaîne.
Lorsque la chaîne de texte fournie contient des caractères de nouvelle ligne (et se compose donc de plusieurs paragraphes), le dernier paragraphe ajouté est renvoyé.
Paramètres
Nom | Type | Description |
---|---|---|
text | String | Chaîne à ajouter en tant que paragraphe. |
Renvois
Paragraph
: Paragraph
est ajouté.
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
append Range(textRange)
Ajoute une copie de la plage de texte fournie à la fin de la plage de texte actuelle.
La mise en forme du texte inséré correspond à celle du texte source.
Paramètres
Nom | Type | Description |
---|---|---|
text | Text | Plage de texte à ajouter. |
Renvois
Text
: plage de texte représentant le texte ajouté.
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
append Range(textRange, matchSourceFormatting)
Ajoute une copie de la plage de texte fournie à la fin de la plage de texte actuelle.
Si la mise en forme est définie pour correspondre à celle du texte de destination, les Auto
de la plage de texte fournie sont remplacés par leurs valeurs affichées. De plus, tous les éléments non textuels de la plage de texte fournie ne sont pas ajoutés.
Paramètres
Nom | Type | Description |
---|---|---|
text | Text | Plage de texte à ajouter. |
match | Boolean | Si la valeur est true , la mise en forme du texte source est conservée. Si la valeur est false , la mise en forme du texte de destination est conservée. |
Renvois
Text
: plage de texte représentant le texte ajouté.
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
append Text(text)
Ajoute du texte à la fin de la plage de texte. Le texte conserve le style de la fin du texte existant.
Paramètres
Nom | Type | Description |
---|---|---|
text | String | Chaîne à ajouter. |
Renvois
Text
: plage de texte représentant le texte ajouté.
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
as Rendered String()
Renvoie le texte affiché délimité par cette plage de la forme ou de la cellule de tableau associée dans un format approprié pour l'affichage aux utilisateurs finaux.
Les éléments de texte Auto
Renvois
String
: texte affiché dans la plage.
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
as String()
Renvoie le texte brut délimité par cette plage de la forme ou de la cellule de tableau associée.
Auto
Renvois
String
: texte brut de la plage.
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
clear()
Efface le texte délimité par cette plage.
Étant donné que l'intégralité du texte d'une forme ou d'une cellule de tableau doit se terminer par un saut de ligne, le saut de ligne final du texte n'est pas supprimé.
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
clear(startOffset, endOffset)
Efface le texte délimité par les décalages de début et de fin dans la plage.
Étant donné que le texte doit se terminer par un retour à la ligne, le retour à la ligne final du texte n'est pas supprimé, même s'il est couvert par les décalages indiqués.
Paramètres
Nom | Type | Description |
---|---|---|
start | Integer | Nombre de caractères après l'index de début de la plage de texte actuelle utilisé pour déterminer l'index de début inclusif de la plage à effacer. Le décalage de début doit être supérieur ou égal à 0 et inférieur ou égal à end . start doit également être inférieur à la longueur de la plage actuelle. |
end | Integer | Nombre de caractères après l'index de début de la plage de texte actuelle utilisé pour déterminer l'index de fin exclusif de la plage à effacer. end doit être supérieur ou égal à start . end doit également être inférieur ou égal à la longueur de la plage actuelle. |
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
find(pattern)
Renvoie toutes les plages correspondant au modèle de recherche dans la plage de texte actuelle. La recherche est sensible à la casse.
Paramètres
Nom | Type | Description |
---|---|---|
pattern | String | Modèle d'expression régulière à rechercher. Toute barre oblique inverse dans le modèle doit être placée en échappement. |
Renvois
Text
: liste de plages de 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
find(pattern, startOffset)
Renvoie toutes les plages correspondant au modèle de recherche dans la plage de texte actuelle à partir du décalage de début. La recherche est sensible à la casse.
Paramètres
Nom | Type | Description |
---|---|---|
pattern | String | Modèle d'expression régulière à rechercher. Toute barre oblique inverse dans le modèle doit être placée en échappement. |
start | Integer | Nombre de caractères après l'index de début de la plage de texte actuelle utilisé pour déterminer l'index de début inclusif de la plage à rechercher. start doit également être inférieur à la longueur de la plage actuelle. |
Renvois
Text
: liste de plages de 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 Auto Texts()
Renvoie les textes automatiques dans la plage de texte actuelle.
Renvois
Auto
: liste de textes automatiques.
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 End Index()
Renvoie l'index exclusif (à partir de 0) du dernier caractère de cette plage. Si les index de début et de fin sont égaux, la plage est considérée comme vide.
Renvois
Integer
: index de fin de la plage.
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 Length()
Renvoie le nombre de caractères dans cette plage.
Renvois
Integer
: nombre de caractères dans cette plage.
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 Links()
Renvoie une collection de plages de texte qui correspondent à tous les Link
dans la plage de texte actuelle ou qui la chevauchent.
Chaque plage renvoyée est garantie de couvrir un lien lors de sa création. Les modifications de texte peuvent faire en sorte qu'il ne représente plus exactement un seul lien.
Chaque Link
des plages renvoyées est accessible via Text
.
// Accesses the first link on a TextRange object. const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText(); const linkTextRange = textRange.getLinks()[0]; const textStyle = linkTextRange.getTextStyle(); Logger.log(textStyle.hasLink()); // logs 'true' const link = textStyle.getLink(); // Link object
Renvois
Text
: liste de plages de 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 List Paragraphs()
Renvoie les paragraphes des listes qui chevauchent la plage de texte actuelle.
Renvois
Paragraph[]
: liste de paragraphes dans des listes.
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 List Style()
Renvoie le List
de la plage de texte actuelle.
Renvois
List
: style de liste de la plage de texte actuelle.
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 Paragraph Style()
Renvoie le Paragraph
de la plage de texte actuelle.
Renvois
Paragraph
: style de paragraphe de la plage de texte actuelle.
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 Paragraphs()
Renvoie les paragraphes qui chevauchent la plage de texte actuelle.
Renvois
Paragraph[]
: liste de paragraphes.
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 Range(startOffset, endOffset)
Renvoie un nouvel Text
couvrant une partie de la plage dont il est issu.
Paramètres
Nom | Type | Description |
---|---|---|
start | Integer | Nombre de caractères après l'index de début de la plage de texte actuelle utilisé pour déterminer l'index de début inclusif de la plage renvoyée. Le décalage de début doit être supérieur ou égal à 0 et inférieur ou égal à end . start doit également être inférieur à la longueur de la plage actuelle. |
end | Integer | Nombre de caractères après l'index de départ de la plage de texte actuelle utilisé pour déterminer l'index de fin exclusif de la plage renvoyée. end doit être supérieur ou égal à start . end doit également être inférieur ou égal à la longueur de la plage actuelle. |
Renvois
Text
: nouvelle plage de 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 Runs()
Renvoie les séries de texte qui chevauchent la plage de texte actuelle. Une série de texte est un segment de texte dont tous les caractères ont le même style.
Chaque plage renvoyée n'est garantie de couvrir qu'une seule exécution lors de sa création. Si vous modifiez le texte ou le style, il est possible que le texte ne représente plus exactement une seule série.
Renvois
Text
: liste de plages de 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 Start Index()
Renvoie l'index inclusif basé sur 0 du premier caractère de cette plage. Si les index de début et de fin sont égaux, la plage est considérée comme vide.
Renvois
Integer
: index de début de la plage.
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 Text Style()
Renvoie le style de texte de la plage ou null
si la plage est vide.
Renvois
Text
: style de texte de la plage.
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
insert Paragraph(startOffset, text)
Insère un paragraphe au décalage de début. Le paragraphe conserve le style de la plage de texte actuelle au niveau du décalage de début.
La chaîne de texte fournie est insérée en tant que paragraphe en ajoutant au moins un caractère de nouvelle ligne autour de la chaîne.
Lorsque la chaîne de texte fournie contient des caractères de nouvelle ligne (et se compose donc de plusieurs paragraphes), le dernier paragraphe ajouté est renvoyé.
Paramètres
Nom | Type | Description |
---|---|---|
start | Integer | Nombre de caractères après l'index de départ de la plage de texte actuelle utilisé pour déterminer l'index de départ inclusif du texte à insérer. |
text | String | Chaîne à insérer. |
Renvois
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
insert Range(startOffset, textRange)
Insère une copie de la plage de texte fournie au décalage de début.
La mise en forme du texte inséré correspond à celle du texte source.
Paramètres
Nom | Type | Description |
---|---|---|
start | Integer | Nombre de caractères après l'index de départ de la plage de texte actuelle utilisé pour déterminer l'index de départ inclusif du texte à insérer. |
text | Text | Plage de texte à insérer. |
Renvois
Text
: plage de texte représentant le texte inséré.
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
insert Range(startOffset, textRange, matchSourceFormatting)
Insère une copie de la plage de texte fournie au décalage de début.
Si la mise en forme est définie pour correspondre à celle du texte de destination, les Auto
de la plage de texte fournie sont remplacés par leurs valeurs affichées. De plus, tous les éléments non textuels de la plage de texte fournie ne sont pas insérés.
Paramètres
Nom | Type | Description |
---|---|---|
start | Integer | Nombre de caractères après l'index de départ de la plage de texte actuelle utilisé pour déterminer l'index de départ inclusif du texte à insérer. |
text | Text | Plage de texte à insérer. |
match | Boolean | Si la valeur est true , la mise en forme du texte source est conservée. Si la valeur est false , la mise en forme du texte de destination est conservée. |
Renvois
Text
: plage de texte représentant le texte inséré.
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
insert Text(startOffset, text)
Insère du texte au décalage de début. Le texte conserve le style du texte existant au décalage de début.
Paramètres
Nom | Type | Description |
---|---|---|
start | Integer | Nombre de caractères après l'index de départ de la plage de texte actuelle utilisé pour déterminer l'index de départ inclusif du texte à insérer. |
text | String | Chaîne à insérer. |
Renvois
Text
: plage de texte représentant le texte inséré.
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 Empty()
Renvoie true
si cette plage ne contient aucun caractère et false
dans le cas contraire.
Renvois
Boolean
: true
si aucun caractère ne se trouve dans cette plage, et false
dans le cas contraire.
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
replace All Text(findText, replaceText)
Remplace toutes les instances du texte à rechercher par le texte de remplacement. La recherche n'est pas sensible à la casse.
Paramètres
Nom | Type | Description |
---|---|---|
find | String | Texte à rechercher. |
replace | String | Texte à utiliser pour remplacer le texte correspondant. |
Renvois
Integer
: le nombre d'occurrences a changé
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
replace All Text(findText, replaceText, matchCase)
Remplace toutes les instances du texte à rechercher par le texte de remplacement.
Paramètres
Nom | Type | Description |
---|---|---|
find | String | Texte à rechercher. |
replace | String | Texte à utiliser pour remplacer le texte correspondant. |
match | Boolean | Si la valeur est true , la recherche est sensible à la casse. Si la valeur est false , la recherche n'est pas sensible à la casse. |
Renvois
Integer
: le nombre d'occurrences a changé
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
select()
Sélectionne uniquement le Text
dans la présentation active et supprime toute sélection précédente.
Un script ne peut accéder à la sélection de l'utilisateur qui l'exécute que s'il est associé à la présentation.
Le Page
parent du Shape
ou du Table
correspondant est défini comme current page selection
. Shape
ou Table
est défini comme selected page element
.
Selection
peut être de deux types :
- 1. Plage de texte : utilisez la sélection sur une plage de texte non vide pour sélectionner la plage de caractères.
- 2. Position du curseur : utilisez un TextRange vide pour placer le curseur à l'index souhaité.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; shape.getText().setText('Hello'); // Range selection: Select the text range "He". shape.getText().getRange(0, 2).select(); // Cursor selection: Place the cursor after "H" like "H|ello". shape.getText().getRange(1, 1).select();
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 Text(newText)
Définit le texte délimité par cette plage de la forme ou de la cellule de tableau associée. Le texte conserve la mise en forme du début du texte existant.
Paramètres
Nom | Type | Description |
---|---|---|
new | String | Chaîne à définir comme nouveau texte. |
Renvois
Text
: plage de texte représentant le texte défini.
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