Cette page a été traduite par l'API Cloud Translation.

Class Shape

PageElement représentant une forme générique qui n'a pas de classification plus spécifique. Inclut les zones de texte, les rectangles et d'autres formes prédéfinies.

Méthodes

Méthode	Type renvoyé	Brève description
`alignOnPage(alignmentPosition)`	`Shape`	Aligne l'élément sur la position d'alignement spécifiée sur la page.
`bringForward()`	`Shape`	Fait avancer l'élément de page d'un élément.
`bringToFront()`	`Shape`	Place l'élément de page au premier plan.
`duplicate()`	`PageElement`	Duplique l'élément de page.
`getAutofit()`	`Autofit`	Renvoie l'`Autofit` du texte dans cette forme.
`getBorder()`	`Border`	Renvoie le `Border` de la forme.
`getConnectionSites()`	`ConnectionSite[]`	Renvoie la liste des `ConnectionSite` de l'élément de page, ou une liste vide si l'élément de page ne comporte aucun site de connexion.
`getContentAlignment()`	`ContentAlignment`	Renvoie l'`ContentAlignment` du texte dans la forme.
`getDescription()`	`String`	Renvoie la description du texte alternatif de l'élément de page.
`getFill()`	`Fill`	Renvoie le `Fill` de la forme.
`getHeight()`	`Number`	Récupère la hauteur de l'élément en points, qui correspond à la hauteur de la zone de délimitation de l'élément lorsqu'il n'est pas en rotation.
`getInherentHeight()`	`Number`	Renvoie la hauteur inhérente de l'élément en points.
`getInherentWidth()`	`Number`	Renvoie la largeur inhérente de l'élément en points.
`getLeft()`	`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 pivoté.
`getLink()`	`Link`	Renvoie `Link` ou `null` s'il n'y a pas de lien.
`getObjectId()`	`String`	Renvoie l'ID unique de cet objet.
`getPageElementType()`	`PageElementType`	Renvoie le type de l'élément de page, représenté sous la forme d'une énumération `PageElementType`.
`getParentGroup()`	`Group`	Renvoie le groupe auquel appartient cet élément de page, ou `null` si l'élément ne fait pas partie d'un groupe.
`getParentPage()`	`Page`	Renvoie la page sur laquelle se trouve cet élément de page.
`getParentPlaceholder()`	`PageElement`	Renvoie l'élément de page parent de l'espace réservé.
`getPlaceholderIndex()`	`Integer`	Renvoie l'index de l'espace réservé de la forme.
`getPlaceholderType()`	`PlaceholderType`	Renvoie le type d'espace réservé de la forme, ou `PlaceholderType.NONE` si la forme n'est pas un espace réservé.
`getRotation()`	`Number`	Renvoie l'angle de rotation de l'élément dans le sens des aiguilles d'une montre autour de son centre, en degrés, où zéro degré signifie aucune rotation.
`getShapeType()`	`ShapeType`	Renvoie le type de la forme.
`getText()`	`TextRange`	Renvoie le contenu textuel de la forme.
`getTitle()`	`String`	Renvoie le titre du texte alternatif de l'élément de page.
`getTop()`	`Number`	Récupère 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 en rotation.
`getTransform()`	`AffineTransform`	Renvoie la transformation de l'élément de page.
`getWidth()`	`Number`	Renvoie la largeur de l'élément en points, qui correspond à la largeur de la zone de délimitation de l'élément lorsqu'il n'est pas en rotation.
`preconcatenateTransform(transform)`	`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.
`removeLink()`	`void`	Supprime un `Link`.
`replaceWithImage(blobSource)`	`Image`	Remplace cette forme par une image fournie par un `BlobSource`.
`replaceWithImage(blobSource, crop)`	`Image`	Remplace cette forme par une image fournie par un `BlobSource`.
`replaceWithImage(imageUrl)`	`Image`	Remplace cette forme par une image.
`replaceWithImage(imageUrl, crop)`	`Image`	Remplace cette forme par une image.
`replaceWithSheetsChart(sourceChart)`	`SheetsChart`	Remplace cette forme par un graphique Google Sheets.
`replaceWithSheetsChartAsImage(sourceChart)`	`Image`	Remplace cette forme par une image d'un graphique Google Sheets.
`scaleHeight(ratio)`	`Shape`	Étale la hauteur de l'élément selon le ratio spécifié.
`scaleWidth(ratio)`	`Shape`	Étale la largeur de l'élément selon le format spécifié.
`select()`	`void`	Sélectionne uniquement le `PageElement` dans la présentation active et supprime toute sélection précédente.
`select(replace)`	`void`	Sélectionne le `PageElement` dans la présentation active.
`sendBackward()`	`Shape`	Fait reculer l'élément de page d'un élément.
`sendToBack()`	`Shape`	Met l'élément de page à l'arrière de la page.
`setContentAlignment(contentAlignment)`	`Shape`	Définit la `ContentAlignment` du texte dans la forme.
`setDescription(description)`	`Shape`	Définit la description du texte alternatif de l'élément de page.
`setHeight(height)`	`Shape`	Définit la hauteur de l'élément en points, qui correspond à la hauteur de la zone de délimitation de l'élément lorsqu'il n'est pas en rotation.
`setLeft(left)`	`Shape`	Définit la position horizontale 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é.
`setLinkSlide(slideIndex)`	`Link`	Définit un `Link` sur l'`Slide` donné à l'aide de l'indice de la diapositive basé sur zéro.
`setLinkSlide(slide)`	`Link`	Définit un `Link` sur l'`Slide` donné. Le lien est défini par l'ID de diapositive donné.
`setLinkSlide(slidePosition)`	`Link`	Définit un `Link` sur l'`Slide` donné à l'aide de la position relative de la diapositive.
`setLinkUrl(url)`	`Link`	Définit un `Link` sur la chaîne d'URL non vide donnée.
`setRotation(angle)`	`Shape`	Définit l'angle de rotation de l'élément dans le sens des aiguilles d'une montre autour de son centre, en degrés.
`setTitle(title)`	`Shape`	Définit le titre du texte alternatif de l'élément de page.
`setTop(top)`	`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 en rotation.
`setTransform(transform)`	`Shape`	Définit la transformation de l'élément de page avec la transformation fournie.
`setWidth(width)`	`Shape`	Définit la largeur de l'élément en points, qui correspond à la largeur de la zone de délimitation de l'élément lorsque celui-ci n'est pas en rotation.

Documentation détaillée

`alignOnPage(alignmentPosition)`

Aligne l'élément sur la position d'alignement spécifiée sur la page.

Paramètres

Nom	Type	Description
`alignmentPosition`	`AlignmentPosition`	Position à laquelle aligner cet élément de page.

Renvois

Shape : cet élément de page, pour le chaînage.

`bringForward()`

Fait avancer l'élément de page d'un élément.

L'élément de page ne doit pas faire partie d'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 champs d'application suivants:

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

`bringToFront()`

Place l'élément de page au premier plan.

L'élément de page ne doit pas faire partie d'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 champs d'application suivants:

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

`duplicate()`

Duplique l'élément de page.

L'élément de page dupliqué est placé sur la même page, à la même position que l'élément d'origine.

Renvois

PageElement : nouveau double de cet élément de page.

Autorisation

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

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

`getAutofit()`

Renvoie l'Autofit du texte dans cette forme. Il s'agit de null si la forme n'autorise pas de texte.

Renvois

Autofit : ajustement automatique du texte dans cette forme.

Autorisation

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

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

`getBorder()`

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 champs d'application suivants:

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

`getConnectionSites()`

Renvoie la liste des ConnectionSite de l'élément de page, ou une liste vide si l'élément de page ne comporte aucun site de connexion.

Renvois

ConnectionSite[] : liste des sites de connexion, qui peut être vide si cet élément ne comporte aucun site de connexion.

Autorisation

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

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

`getContentAlignment()`

Renvoie l'ContentAlignment du texte dans la forme.

Renvois

ContentAlignment : alignement du texte dans cette forme.

Autorisation

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

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

`getDescription()`

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 champs d'application suivants:

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

`getFill()`

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 champs d'application suivants:

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

`getHeight()`

Récupère la hauteur de l'élément en points, qui correspond à la hauteur de la zone de délimitation de l'élément lorsqu'il n'est pas en rotation.

Cette méthode n'est pas compatible avec tous les éléments de la 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 : 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 champs d'application suivants:

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

`getInherentHeight()`

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 inhérente en conjonction avec la transformation de l'élément pour déterminer son apparence visuelle finale.

Renvois

Number : 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 champs d'application suivants:

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

`getInherentWidth()`

Renvoie la largeur inhérente de l'élément en points.

Renvois

Number : 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 champs d'application suivants:

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

`getLeft()`

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 pivoté.

Renvois

Number : position horizontale de cet é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 champs d'application suivants:

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

`getLink()`

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 : Link ou null si aucun lien n'est associé.

Autorisation

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

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

`getObjectId()`

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 : ID unique de cet objet.

Autorisation

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

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

`getPageElementType()`

Renvoie le type de l'élément de page, représenté sous la forme d'une énumération PageElementType.

Renvois

PageElementType : type de l'élément de page.

Autorisation

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

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

`getParentGroup()`

Renvoie le groupe auquel appartient cet élément de page, ou null si l'élément ne fait pas partie d'un groupe.

Renvois

Group : 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 champs d'application suivants:

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

`getParentPage()`

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 champs d'application suivants:

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

`getParentPlaceholder()`

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 si elle n'a pas de parent.

Renvois

PageElement : é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 champs d'application suivants:

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

`getPlaceholderIndex()`

Renvoie l'index de l'espace réservé de la forme. Si deux instances ou plus du même type d'espace réservé sont présentes sur la même page, chacune d'elles a sa propre valeur d'index unique. Affiche null si la forme n'est pas un espace réservé.

Renvois

Integer : indice 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 champs d'application suivants:

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

`getPlaceholderType()`

Renvoie le type d'espace réservé de la forme, ou PlaceholderType.NONE si la forme n'est pas un espace réservé.

Renvois

PlaceholderType : 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 champs d'application suivants:

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

`getRotation()`

Renvoie l'angle de rotation de l'élément dans le sens des aiguilles d'une montre autour de son centre, en degrés, où zéro degré signifie aucune rotation.

Renvois

Number : angle de rotation en degrés, compris entre 0 (inclus) et 360 (exclu).

Autorisation

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

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

`getShapeType()`

Renvoie le type de la forme.

Renvois

ShapeType : type de cette forme.

`getText()`

Renvoie le contenu textuel de la forme.

Le texte d'une forme se termine toujours par un caractère de nouvelle ligne.

Renvois

TextRange : contenu textuel de cette forme.

Autorisation

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

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

`getTitle()`

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 champs d'application suivants:

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

`getTop()`

Récupère 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 en rotation.

Renvois

Number : position verticale de cet é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 champs d'application suivants:

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

`getTransform()`

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

AffineTransform : transformation de l'élément de page.

Autorisation

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

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

`getWidth()`

Renvoie la largeur de l'élément en points, qui correspond à la largeur de la zone de délimitation de l'élément lorsqu'il n'est pas en rotation.

Renvois

Number : 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 champs d'application suivants:

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

`preconcatenateTransform(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 setTransform(transform).

Paramètres

Nom	Type	Description
`transform`	`AffineTransform`	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 champs d'application 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é PageElement est supprimé sur un modèle ou une mise en page, tous les espaces réservés hérités vides sont également supprimés.

Autorisation

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

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

`removeLink()`

Supprime un Link.

const slides = SlidesApp.getActivePresentation().getSlides();
slides[1].getShapes()[0].removeLink();

`replaceWithImage(blobSource)`

Remplace cette forme par une image fournie par un BlobSource.

L'image est extraite de l'BlobSource fournie une fois au moment de l'insertion, et une copie est stockée pour être affichée dans la présentation. Les images doivent être inférieures à 50 Mo, ne pas dépasser 25 mégapixels et être au format PNG, JPEG ou GIF.

Pour conserver le format 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
`blobSource`	`BlobSource`	Données d'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 champs d'application suivants:

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

`replaceWithImage(blobSource, crop)`

Remplace cette forme par une image fournie par un BlobSource.

L'insertion de l'image la récupère une fois à partir de BlobSource, et une copie est stockée pour l'affichage dans la présentation. Les images doivent être inférieures à 50 Mo, ne pas dépasser 25 mégapixels et être au format PNG, JPEG ou GIF.

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
`blobSource`	`BlobSource`	Données d'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 champs d'application suivants:

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

`replaceWithImage(imageUrl)`

Remplace cette forme par une image.

Lorsque vous insérez l'image, elle est récupérée à partir de l'URL une seule fois, et une copie est stockée pour être affichée dans la présentation. Les images doivent être inférieures à 50 Mo, ne pas dépasser 25 mégapixels et ê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 le format 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
`imageUrl`	`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 champs d'application suivants:

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

`replaceWithImage(imageUrl, crop)`

Remplace cette forme par une image.

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
`imageUrl`	`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 champs d'application suivants:

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

`replaceWithSheetsChart(sourceChart)`

Remplace cette forme par un graphique Google Sheets.

Le graphique est associé au graphique Google Sheets source, ce qui permet de le mettre à jour. Les autres collaborateurs voient 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
`sourceChart`	`EmbeddedChart`	Graphique dans une feuille de calcul qui remplace la forme.

Renvois

SheetsChart : graphique qui a remplacé la forme.

Autorisation

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

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

`replaceWithSheetsChartAsImage(sourceChart)`

Remplace cette forme par une image d'un graphique Google Sheets.

Pour conserver le format du graphique Google Sheets, l'image du graphique est redimensionnée et centrée par rapport à la taille de la forme existante.

L'image du graphique n'est pas associée au graphique Google Sheets source.

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
`sourceChart`	`EmbeddedChart`	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 champs d'application suivants:

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

`scaleHeight(ratio)`

Étale la hauteur de l'élément selon le ratio spécifié. La hauteur de l'élément correspond à la hauteur de sa zone de délimitation lorsque l'élément n'est pas en rotation.

Paramètres

Nom	Type	Description
`ratio`	`Number`	Rapport de scaling de 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 champs d'application suivants:

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

`scaleWidth(ratio)`

Étale la largeur de l'élément selon le format spécifié. La largeur de l'élément correspond à la largeur de sa zone de délimitation lorsque l'élément n'est pas en rotation.

Paramètres

Nom	Type	Description
`ratio`	`Number`	Ratio de scaling de 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 champs d'application suivants:

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

`select()`

Sélectionne uniquement le PageElement 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 qu'à la sélection de l'utilisateur qui l'exécute, et uniquement si le script est lié à la présentation.

Cela définit le Page parent de PageElement sur 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 champs d'application suivants:

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

`select(replace)`

Sélectionne le PageElement dans la présentation active.

Un script ne peut accéder qu'à la sélection de l'utilisateur qui l'exécute, et uniquement si le script est lié à la présentation.

Transmettez true à cette méthode pour ne sélectionner que le PageElement et supprimer toute sélection précédente. Cela définit également le Page parent du PageElement en tant que current page selection.

Transmettez false pour sélectionner plusieurs objets PageElement. Les objets PageElement 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 Page parent de l'objet PageElement doit être current page selection.
Vous ne devez pas sélectionner plusieurs objets Page.

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 sur cette 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, la sélection 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 champs d'application suivants:

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

`sendBackward()`

Fait reculer l'élément de page d'un élément.

L'élément de page ne doit pas faire partie d'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 champs d'application suivants:

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

`sendToBack()`

Met l'élément de page à l'arrière de la page.

L'élément de page ne doit pas faire partie d'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 champs d'application suivants:

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

`setContentAlignment(contentAlignment)`

Définit la ContentAlignment 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
`contentAlignment`	`ContentAlignment`	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 champs d'application suivants:

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

`setDescription(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 à définir comme 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 champs d'application suivants:

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

`setHeight(height)`

Définit la hauteur de l'élément en points, qui correspond à la hauteur de la zone de délimitation de l'élément lorsqu'il n'est pas en rotation.

Paramètres

Nom	Type	Description
`height`	`Number`	Nouvelle hauteur de cet é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 champs d'application suivants:

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

`setLeft(left)`

Définit la position horizontale 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
`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 champs d'application suivants:

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

`setLinkSlide(slideIndex)`

Définit un Link sur l'Slide donné à l'aide de l'indice de la diapositive basé sur zéro.

// 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
`slideIndex`	`Integer`	Index basé sur zéro de la diapositive.

Renvois

Link : Link défini.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 l'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 : Link défini.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 l'Slide donné à l'aide de 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
`slidePosition`	`SlidePosition`	`SlidePosition` relatif.

Renvois

Link : Link défini.

Autorisation

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

// 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 : Link défini.

Autorisation

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

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

`setRotation(angle)`

Définit l'angle de rotation de l'élément dans le sens des aiguilles d'une montre autour de son centre, en degrés.

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 champs d'application suivants:

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

`setTitle(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 à définir comme 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 champs d'application suivants:

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

`setTop(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 en rotation.

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 champs d'application suivants:

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

`setTransform(transform)`

Définit la transformation de l'élément de page avec la transformation fournie.

Modifier la transformation d'un groupe modifie la transformation absolue des éléments de page de ce groupe, ce qui peut modifier leur apparence visuelle.

Modifier la transformation d'un élément de page appartenant à un groupe ne modifie que la transformation de cet élément de page. Cela n'a aucune incidence sur les transformations du groupe ni sur les 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 getTransform().

Paramètres

Nom	Type	Description
`transform`	`AffineTransform`	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 champs d'application suivants:

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

`setWidth(width)`

Définit la largeur de l'élément en points, qui correspond à la largeur de la zone de délimitation de l'élément lorsque celui-ci n'est pas en rotation.

Paramètres

Nom	Type	Description
`width`	`Number`	Nouvelle largeur de cet é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 champs d'application suivants:

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