Page représentant une forme générique qui n'a pas de classification plus spécifique. Inclut des zones de texte, des rectangles et d'autres formes prédéfinies.
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
align | Shape | Aligne l'élément sur la position d'alignement spécifiée sur la page. |
bring | Shape | Fait avancer l'élément de page d'un élément. |
bring | Shape | Place l'élément de page au premier plan. |
duplicate() | Page | Duplique l'élément de la page. |
get | Autofit|null | Renvoie le Autofit du texte contenu dans cette forme. |
get | Border | Renvoie le Border de la forme. |
get | Connection | Renvoie la liste des Connection sur l'élément de page, ou une liste vide si l'élément de page ne comporte aucun site de connexion. |
get | Content | Renvoie le Content du texte dans la forme. |
get | String | Renvoie la description du texte alternatif de l'élément de page. |
get | Fill | Renvoie le Fill de la forme. |
get | Number|null | Obtient la hauteur de l'élément en points, qui correspond à la hauteur du cadre de sélection de l'élément lorsque celui-ci n'est pas en rotation. |
get | Number|null | Renvoie la hauteur inhérente de l'élément en points. |
get | Number|null | Renvoie la largeur inhérente de l'élément en points. |
get | Number | Renvoie la position horizontale de l'élément en points, mesurée à partir de l'angle supérieur gauche de la page lorsque l'élément n'est pas en rotation. |
get | Link|null | Renvoie Link ou null s'il n'y a pas de lien. |
get | String | Renvoie l'ID unique de cet objet. |
get | Page | Renvoie le type de l'élément de page, représenté sous la forme d'un enum Page. |
get | Group|null | Renvoie le groupe auquel appartient cet élément de page, ou null si l'élément n'appartient à aucun groupe. |
get | Page | Renvoie la page sur laquelle se trouve cet élément de page. |
get | Page | Renvoie l'élément de page parent de l'espace réservé. |
get | Integer|null | Renvoie l'index de l'espace réservé de la forme. |
get | Placeholder | Renvoie le type d'espace réservé de la forme ou Placeholder si la forme n'est pas un espace réservé. |
get | Number | Renvoie l'angle de rotation de l'élément autour de son centre dans le sens des aiguilles d'une montre, en degrés. Zéro degré signifie qu'il n'y a pas de rotation. |
get | Shape | Renvoie le type de forme. |
get | Text | Renvoie le contenu textuel de la forme. |
get | String | Renvoie le titre du texte alternatif de l'élément de page. |
get | Number | Obtient la position verticale de l'élément en points, mesurée à partir du coin supérieur gauche de la page lorsque l'élément n'est pas pivoté. |
get | Affine | Renvoie la transformation de l'élément de page. |
get | Number|null | Renvoie la largeur de l'élément en points, qui correspond à la largeur du cadre de sélection de l'élément lorsque celui-ci n'est pas pivoté. |
preconcatenate | Shape | Préconcatène la transformation fournie à la transformation existante de l'élément de page. |
remove() | void | Supprime l'élément de la page. |
remove | void | Supprime une Link. |
replace | Image | Remplace cette forme par une image fournie par un Blob. |
replace | Image | Remplace cette forme par une image fournie par un Blob. |
replace | Image | Remplace cette forme par une image. |
replace | Image | Remplace cette forme par une image. |
replace | Sheets | Remplace cette forme par un graphique Google Sheets. |
replace | Image | Remplace cette forme par une image d'un graphique Google Sheets. |
scale | Shape | Met à l'échelle la hauteur de l'élément selon le ratio spécifié. |
scale | Shape | Met à l'échelle la largeur de l'élément selon le ratio spécifié. |
select() | void | Sélectionne uniquement le Page dans la présentation active et supprime toute sélection précédente. |
select(replace) | void | Sélectionne le Page dans la présentation active. |
send | Shape | Envoie l'élément de page vers l'arrière d'un élément. |
send | Shape | Envoie l'élément de page à l'arrière-plan de la page. |
set | Shape | Définit la Content du texte dans la forme. |
set | Shape | Définit la description du texte alternatif de l'élément de page. |
set | Shape | Définit la hauteur de l'élément en points, qui correspond à la hauteur du cadre de sélection de l'élément lorsque celui-ci n'est pas en rotation. |
set | Shape | Définit la position horizontale de l'élément en points, mesurée à partir de l'angle supérieur gauche de la page lorsque l'élément n'est pas pivoté. |
set | Link | Définit un Link sur le Slide donné à l'aide de l'index base zéro de la diapositive. |
set | Link | Définit un Link sur le Slide donné. Le lien est défini par l'ID de diapositive donné. |
set | Link | Définit un Link sur le Slide donné en utilisant la position relative de la diapositive. |
set | Link | Définit un Link sur la chaîne d'URL non vide donnée. |
set | Shape | Définit l'angle de rotation de l'élément autour de son centre (dans le sens des aiguilles d'une montre), en degrés. |
set | Shape | Définit le titre du texte alternatif de l'élément de page. |
set | Shape | Définit la position verticale de l'élément en points, mesurée à partir du coin supérieur gauche de la page lorsque l'élément n'est pas pivoté. |
set | Shape | Définit la transformation de l'élément de page avec la transformation fournie. |
set | Shape | Définit la largeur de l'élément en points, qui correspond à la largeur du cadre de sélection de l'élément lorsque celui-ci n'est pas pivoté. |
Documentation détaillée
align On Page(alignmentPosition)
Aligne l'élément sur la position d'alignement spécifiée sur la page.
Paramètres
| Nom | Type | Description |
|---|---|---|
alignment | Alignment | Position à laquelle aligner cet élément de page. |
Renvois
Shape : cet élément de page, pour le chaînage.
bring Forward()
Fait avancer l'élément de page d'un élément.
L'élément de page ne doit pas se trouver dans un groupe.
Renvois
Shape : cet élément de page, 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
bring To Front()
Place l'élément de page au premier plan.
L'élément de page ne doit pas se trouver dans un groupe.
Renvois
Shape : cet élément de page, 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
duplicate()
Duplique l'élément de la page.
L'élément de page dupliqué est placé sur la même page, au même emplacement que l'original.
Renvois
Page : nouveau doublon de cet élément de page.
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 Autofit()
Renvoie le Autofit du texte contenu dans cette forme. La valeur est null si la forme n'autorise pas le texte.
Renvois
Autofit|null : ajustement automatique du texte dans cette forme.
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 Border()
Renvoie le Border de la forme.
Renvois
Border : paramètre de bordure de cette forme.
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 Connection Sites()
Renvoie la liste des Connection sur l'élément de page, ou une liste vide si l'élément de page ne comporte aucun site de connexion.
Renvois
Connection : liste des sites de connexion, qui peut être vide si cet élément n'en comporte aucun.
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 Content Alignment()
Renvoie le Content du texte dans la forme.
Renvois
Content : alignement du texte dans cette forme.
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 Description()
Renvoie la description du texte alternatif de l'élément de page. La description est combinée au titre pour afficher et lire le texte alternatif.
Renvois
String : description du texte alternatif de l'élément de page.
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 Fill()
Renvoie le Fill de la forme.
Renvois
Fill : paramètre de remplissage de cette forme.
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 Height()
Obtient la hauteur de l'élément en points, qui correspond à la hauteur du cadre de sélection de l'élément lorsque celui-ci n'est pas en rotation.
Cette méthode n'est pas compatible avec tous les éléments de page. Pour savoir quels éléments de page ne sont pas compatibles avec cette méthode, consultez les limites de dimensionnement et de positionnement.
Renvois
Number|null : hauteur inhérente de l'élément de page en points, ou null si l'élément de page n'a pas de hauteur.
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 Inherent Height()
Renvoie la hauteur inhérente de l'élément en points.
La transformation de l'élément de page est relative à sa taille intrinsèque. Utilisez la taille intrinsèque en combinaison avec la transformation de l'élément pour déterminer son apparence visuelle finale.
Renvois
Number|null : hauteur inhérente de l'élément de page en points, ou null si l'élément de page n'a pas de hauteur.
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 Inherent Width()
Renvoie la largeur inhérente de l'élément en points.
La transformation de l'élément de page est relative à sa taille intrinsèque. Utilisez la taille intrinsèque en combinaison avec la transformation de l'élément pour déterminer son apparence visuelle finale.
Renvois
Number|null : largeur inhérente de l'élément de page en points, ou null si l'élément de page n'a pas de largeur.
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 Left()
Renvoie la position horizontale de l'élément en points, mesurée à partir de l'angle supérieur gauche de la page lorsque l'élément n'est pas en rotation.
Renvois
Number : position horizontale de cet élément en points, à partir de l'angle supérieur gauche de la page.
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 Link()
Renvoie Link ou null s'il n'y a pas de lien.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; const link = shape.getLink(); if (link != null) { Logger.log(`Shape has a link of type: ${link.getLinkType()}`); }
Renvois
Link|null : Link ou null si aucun lien n'est disponible.
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 Object Id()
Renvoie l'ID unique de cet objet. Les ID d'objet utilisés par les pages et les éléments de page partagent le même espace de noms.
Renvois
String : identifiant unique de cet objet.
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 Page Element Type()
Renvoie le type de l'élément de page, représenté sous la forme d'un enum Page.
Renvois
Page : type de l'élément de page.
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 Parent Group()
Renvoie le groupe auquel appartient cet élément de page, ou null si l'élément n'appartient à aucun groupe.
Renvois
Group|null : groupe auquel appartient cet élément de page, ou null.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
get Parent Page()
Renvoie la page sur laquelle se trouve cet élément de page.
Renvois
Page : page sur laquelle se trouve cet élément.
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 Parent Placeholder()
Renvoie l'élément de page parent de l'espace réservé. Renvoie null si la forme n'est pas un espace réservé ou n'a pas de parent.
Renvois
Page : élément de page parent de cet espace réservé de forme, ou null si cette forme n'est pas un espace réservé ou n'a pas de parent.
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 Placeholder Index()
Renvoie l'index de l'espace réservé de la forme. Si plusieurs instances du même type d'espace réservé sont présentes sur la même page, chacune d'elles possède sa propre valeur d'index unique. Renvoie null si la forme n'est pas un espace réservé.
Renvois
Integer|null : index de l'espace réservé de cette forme ou null si la forme n'est pas un espace réservé.
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 Placeholder Type()
Renvoie le type d'espace réservé de la forme ou Placeholder si la forme n'est pas un espace réservé.
Renvois
Placeholder : type d'espace réservé de cette forme.
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 Rotation()
Renvoie l'angle de rotation de l'élément autour de son centre dans le sens des aiguilles d'une montre, en degrés. Zéro degré signifie qu'il n'y a pas de rotation.
Renvois
Number : angle de rotation en degrés, compris entre 0 (inclus) et 360 (exclus).
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 Shape Type()
get Text()
Renvoie le contenu textuel de la forme.
Le texte dans une forme se termine toujours par un caractère de nouvelle ligne.
Renvois
Text : contenu textuel de cette forme.
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 Title()
Renvoie le titre du texte alternatif de l'élément de page. Le titre est combiné à la description pour afficher et lire le texte alternatif.
Renvois
String : titre du texte alternatif de l'élément de page.
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 Top()
Obtient la position verticale de l'élément en points, mesurée à partir du coin supérieur gauche de la page lorsque l'élément n'est pas pivoté.
Renvois
Number : position verticale de l'élément en points, à partir du coin supérieur gauche de la page.
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 Transform()
Renvoie la transformation de l'élément de page.
L'apparence visuelle de l'élément de page est déterminée par sa transformation absolue. Pour calculer la transformation absolue, préconcaténez la transformation d'un élément de page avec les transformations de tous ses groupes parents. Si l'élément de page ne fait pas partie d'un groupe, sa transformation absolue est identique à la valeur de ce champ.
Renvois
Affine : transformation de l'élément de page.
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 Width()
Renvoie la largeur de l'élément en points, qui correspond à la largeur du cadre de sélection de l'élément lorsque celui-ci n'est pas pivoté.
Cette méthode n'est pas compatible avec tous les éléments de page. Pour savoir quels éléments de page ne sont pas compatibles avec cette méthode, consultez les limites de dimensionnement et de positionnement.
Renvois
Number|null : largeur inhérente de l'élément de page en points, ou null si l'élément de page n'a pas de largeur.
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
preconcatenate Transform(transform)
Préconcatène la transformation fournie à la transformation existante de l'élément de page.
newTransform = argument * existingTransform;
Par exemple, pour déplacer un élément de page de 36 points vers la gauche :
const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; element.preconcatenateTransform( SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(), );
Vous pouvez également remplacer la transformation de l'élément de page par set.
Paramètres
| Nom | Type | Description |
|---|---|---|
transform | Affine | Transformation à préconcaténer sur la transformation de cet élément de page. |
Renvois
Shape : cet élément de page, 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
remove()
Supprime l'élément de la page.
Si, après une opération de suppression, un Group ne contient qu'un seul élément de page ou aucun, le groupe lui-même est également supprimé.
Si un espace réservé Page est supprimé d'un modèle ou d'une mise en page, tous les espaces réservés vides hérités sont également supprimés.
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 Link()
Supprime une Link.
const slides = SlidesApp.getActivePresentation().getSlides(); slides[1].getShapes()[0].removeLink();
replace With Image(blobSource)
Remplace cette forme par une image fournie par un Blob.
L'image est récupérée à partir de l'Blob fourni une seule fois au moment de l'insertion, et une copie est stockée pour être affichée dans la présentation. Les images ne doivent pas dépasser 50 Mo ni 25 mégapixels, et doivent être au format PNG, JPEG ou GIF.
Pour conserver les proportions de l'image, celle-ci est mise à l'échelle et centrée par rapport à la taille de la forme existante.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; // Get the Drive image file with the given ID. const driveImage = DriveApp.getFileById('123abc'); shape.replaceWithImage(driveImage);
Paramètres
| Nom | Type | Description |
|---|---|---|
blob | Blob | Données de l'image. |
Renvois
Image : Image qui a remplacé la forme.
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 With Image(blobSource, crop)
Remplace cette forme par une image fournie par un Blob.
Lorsque vous insérez l'image, elle est récupérée une seule fois à partir de Blob et une copie est stockée pour être affichée dans la présentation. Les images doivent être au format PNG, JPEG ou GIF, ne pas dépasser 50 Mo et ne pas dépasser 25 mégapixels.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; // Get the Drive image file with the given ID. const driveImage = DriveApp.getFileById('123abc'); // Replace and crop the replaced image. shape.replaceWithImage(driveImage, true);
Paramètres
| Nom | Type | Description |
|---|---|---|
blob | Blob | Données de l'image. |
crop | Boolean | Si la valeur est true, l'image est recadrée pour s'adapter à la taille de la forme existante. Sinon, l'image est mise à l'échelle et centrée. |
Renvois
Image : Image qui a remplacé la forme.
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 With Image(imageUrl)
Remplace cette forme par une image.
L'insertion de l'image la récupère une seule fois à partir de l'URL, et une copie est stockée pour être affichée dans la présentation. Les images ne doivent pas dépasser 50 Mo ni 25 mégapixels, et doivent être au format PNG, JPEG ou GIF.
L'URL fournie doit être accessible au public et ne pas dépasser 2 Ko. L'URL elle-même est enregistrée avec l'image et exposée via Image.getSourceUrl().
Pour conserver les proportions de l'image, celle-ci est mise à l'échelle et centrée par rapport à la taille de la forme existante.
Paramètres
| Nom | Type | Description |
|---|---|---|
image | String | URL de l'image à télécharger. |
Renvois
Image : Image qui a remplacé la forme.
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 With Image(imageUrl, crop)
Remplace cette forme par une image.
L'insertion de l'image la récupère une seule fois à partir de l'URL, et une copie est stockée pour être affichée dans la présentation. Les images ne doivent pas dépasser 50 Mo ni 25 mégapixels, et doivent être au format PNG, JPEG ou GIF.
L'URL fournie ne doit pas dépasser 2 Ko. L'URL elle-même est enregistrée avec l'image et exposée via Image.getSourceUrl().
Paramètres
| Nom | Type | Description |
|---|---|---|
image | String | URL de l'image à télécharger. |
crop | Boolean | Si la valeur est true, l'image est recadrée pour s'adapter à la taille de la forme existante. Sinon, l'image est mise à l'échelle et centrée. |
Renvois
Image : Image qui a remplacé la forme.
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 With Sheets Chart(sourceChart)
Remplace cette forme par un graphique Google Sheets.
Le graphique est associé au graphique source Google Sheets, ce qui permet de le mettre à jour. Les autres collaborateurs peuvent voir le lien vers la feuille de calcul source.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Replace the shape with the Sheets chart. const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; shape.replaceWithSheetsChart(chart);
Paramètres
| Nom | Type | Description |
|---|---|---|
source | Embedded | Graphique dans une feuille de calcul qui remplace la forme. |
Renvois
Sheets : graphique qui a remplacé la forme.
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 With Sheets Chart As Image(sourceChart)
Remplace cette forme par une image d'un graphique Google Sheets.
Afin de conserver les proportions du graphique Google Sheets, l'image du graphique est mise à l'échelle et centrée par rapport à la taille de la forme existante.
L'image du graphique n'est pas associée au graphique source Google Sheets.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Replace the shape with the Sheets chart as an image. const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; shape.replaceWithSheetsChartAsImage(chart);
Paramètres
| Nom | Type | Description |
|---|---|---|
source | Embedded | Graphique dans une feuille de calcul qui remplace la forme. |
Renvois
Image : image du graphique qui a remplacé la forme.
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
scale Height(ratio)
Met à l'échelle la hauteur de l'élément selon le ratio spécifié. La hauteur de l'élément correspond à la hauteur de son cadre de sélection lorsque l'élément n'est pas en rotation.
Cette méthode n'est pas compatible avec tous les éléments de page. Pour savoir quels éléments de page ne sont pas compatibles avec cette méthode, consultez les limites de dimensionnement et de positionnement.
Paramètres
| Nom | Type | Description |
|---|---|---|
ratio | Number | Rapport permettant de mettre à l'échelle la hauteur de cet élément de page. |
Renvois
Shape : cet élément de page, 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
scale Width(ratio)
Met à l'échelle la largeur de l'élément selon le ratio spécifié. La largeur de l'élément correspond à la largeur de son cadre de sélection lorsque l'élément n'est pas pivoté.
Cette méthode n'est pas compatible avec tous les éléments de page. Pour savoir quels éléments de page ne sont pas compatibles avec cette méthode, consultez les limites de dimensionnement et de positionnement.
Paramètres
| Nom | Type | Description |
|---|---|---|
ratio | Number | Ratio permettant de mettre à l'échelle la largeur de cet élément de page. |
Renvois
Shape : cet élément de page, 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
select()
Sélectionne uniquement le Page dans la présentation active et supprime toute sélection précédente. Cela revient à appeler select(replace) avec true.
Un script ne peut accéder à la sélection de l'utilisateur qui l'exécute que s'il est associé à la présentation.
Cela définit le Page parent du Page comme current page selection.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const pageElement = slide.getPageElements()[0]; // Only select this page element and replace any previous selection. pageElement.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
select(replace)
Sélectionne le Page dans la présentation active.
Un script ne peut accéder à la sélection de l'utilisateur qui l'exécute que s'il est associé à la présentation.
Transmettez true à cette méthode pour sélectionner uniquement Page et supprimer toute sélection précédente. Cela définit également le Page parent du Page comme current page selection.
Transmettez false pour sélectionner plusieurs objets Page. Les objets Page doivent se trouver dans le même Page.
Les conditions suivantes doivent être remplies lorsque vous sélectionnez un élément de page à l'aide d'un paramètre false :
- Le parent
Pagede l'objetPagedoit êtreElement current page selection. - Plusieurs objets
Pagene doivent pas être sélectionnés.
Pour vous en assurer, l'approche recommandée consiste à sélectionner d'abord le Page parent à l'aide de Page.selectAsCurrentPage(), puis à sélectionner les éléments de la page.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; // First select the slide page, as the current page selection. slide.selectAsCurrentPage(); // Then select all the page elements in the selected slide page. const pageElements = slide.getPageElements(); for (let i = 0; i < pageElements.length; i++) { pageElements[i].select(false); }
Paramètres
| Nom | Type | Description |
|---|---|---|
replace | Boolean | Si la valeur est true, la sélection remplace toute sélection précédente. Sinon, elle est ajoutée à toute sélection précédente. |
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
send Backward()
Envoie l'élément de page vers l'arrière d'un élément.
L'élément de page ne doit pas se trouver dans un groupe.
Renvois
Shape : cet élément de page, 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
send To Back()
Envoie l'élément de page à l'arrière-plan de la page.
L'élément de page ne doit pas se trouver dans un groupe.
Renvois
Shape : cet élément de page, 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 Content Alignment(contentAlignment)
Définit la Content du texte dans la forme.
Cette méthode désactive automatiquement les propriétés d'ajustement automatique du texte sur les formes mises à jour.
Paramètres
| Nom | Type | Description |
|---|---|---|
content | Content | Alignement à définir. |
Renvois
Shape : cette forme, 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 Description(description)
Définit la description du texte alternatif de l'élément de page.
La méthode n'est pas compatible avec les éléments Group.
// Set the first page element's alt text description to "new alt text // description". const pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; pageElement.setDescription('new alt text description'); Logger.log(pageElement.getDescription());
Paramètres
| Nom | Type | Description |
|---|---|---|
description | String | Chaîne permettant de définir la description du texte alternatif. |
Renvois
Shape : élément de cette page.
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 Height(height)
Définit la hauteur de l'élément en points, qui correspond à la hauteur du cadre de sélection de l'élément lorsque celui-ci n'est pas en rotation.
Cette méthode n'est pas compatible avec tous les éléments de page. Pour savoir quels éléments de page ne sont pas compatibles avec cette méthode, consultez les limites de dimensionnement et de positionnement.
Paramètres
| Nom | Type | Description |
|---|---|---|
height | Number | Nouvelle hauteur de l'élément de page à définir, en points. |
Renvois
Shape : cet élément de page, 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 Left(left)
Définit la position horizontale de l'élément en points, mesurée à partir de l'angle supérieur gauche de la page lorsque l'élément n'est pas pivoté.
Paramètres
| Nom | Type | Description |
|---|---|---|
left | Number | Nouvelle position horizontale à définir, en points. |
Renvois
Shape : cet élément de page, 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 Link Slide(slideIndex)
Définit un Link sur le Slide donné à l'aide de l'index base zéro de la diapositive.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(0);
Paramètres
| Nom | Type | Description |
|---|---|---|
slide | Integer | Index basé sur zéro de la diapositive. |
Renvois
Link : le Link qui a été 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
set Link Slide(slide)
Définit un Link sur le Slide donné. Le lien est défini par l'ID de diapositive donné.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(slides[0]);
Paramètres
| Nom | Type | Description |
|---|---|---|
slide | Slide | Slide à associer. |
Renvois
Link : le Link qui a été 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
set Link Slide(slidePosition)
Définit un Link sur le Slide donné en utilisant la position relative de la diapositive.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);
Paramètres
| Nom | Type | Description |
|---|---|---|
slide | Slide | Slide relatif. |
Renvois
Link : le Link qui a été 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
set Link Url(url)
Définit un Link sur la chaîne d'URL non vide donnée.
// Set a link to the URL. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkUrl('https://slides.google.com');
Paramètres
| Nom | Type | Description |
|---|---|---|
url | String | Chaîne d'URL. |
Renvois
Link : le Link qui a été 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
set Rotation(angle)
Définit l'angle de rotation de l'élément autour de son centre (dans le sens des aiguilles d'une montre), en degrés.
Cette méthode n'est pas compatible avec tous les éléments de page. Pour savoir quels éléments de page ne sont pas compatibles avec cette méthode, consultez les limites de dimensionnement et de positionnement.
Paramètres
| Nom | Type | Description |
|---|---|---|
angle | Number | Nouvel angle de rotation dans le sens des aiguilles d'une montre à définir, en degrés. |
Renvois
Shape : cet élément de page, 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 Title(title)
Définit le titre du texte alternatif de l'élément de page.
La méthode n'est pas compatible avec les éléments Group.
// Set the first page element's alt text title to "new alt text title". const pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; pageElement.setTitle('new alt text title'); Logger.log(pageElement.getTitle());
Paramètres
| Nom | Type | Description |
|---|---|---|
title | String | Chaîne permettant de définir le titre du texte alternatif. |
Renvois
Shape : élément de cette page.
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 Top(top)
Définit la position verticale de l'élément en points, mesurée à partir du coin supérieur gauche de la page lorsque l'élément n'est pas pivoté.
Paramètres
| Nom | Type | Description |
|---|---|---|
top | Number | Nouvelle position verticale à définir, en points. |
Renvois
Shape : cet élément de page, 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 Transform(transform)
Définit la transformation de l'élément de page avec la transformation fournie.
La mise à jour de la transformation d'un groupe modifie la transformation absolue des éléments de la page dans ce groupe, ce qui peut modifier leur apparence visuelle.
La mise à jour de la transformation d'un élément de page qui se trouve dans un groupe ne modifie que la transformation de cet élément de page. Elle n'affecte pas les transformations du groupe ni des autres éléments de page du groupe.
Pour en savoir plus sur l'impact des transformations sur l'apparence visuelle des éléments de page, consultez get.
Paramètres
| Nom | Type | Description |
|---|---|---|
transform | Affine | Transformation définie pour cet élément de page. |
Renvois
Shape : cet élément, 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 Width(width)
Définit la largeur de l'élément en points, qui correspond à la largeur du cadre de sélection de l'élément lorsque celui-ci n'est pas pivoté.
Cette méthode n'est pas compatible avec tous les éléments de page. Pour savoir quels éléments de page ne sont pas compatibles avec cette méthode, consultez les limites de dimensionnement et de positionnement.
Paramètres
| Nom | Type | Description |
|---|---|---|
width | Number | Nouvelle largeur de l'élément de page à définir, en points. |
Renvois
Shape : cet élément de page, 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