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 valeur plus spécifique la classification. Comprend 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`	Met en avant l'élément d'un élément sur la page.
`bringToFront()`	`Shape`	Affiche l'élément de page au début de la page.
`duplicate()`	`PageElement`	Duplique l'élément de page.
`getAutofit()`	`Autofit`	Renvoie la valeur `Autofit` du texte contenu dans cette forme.
`getBorder()`	`Border`	Renvoie la valeur `Border` de la forme.
`getConnectionSites()`	`ConnectionSite[]`	Renvoie la liste des valeurs `ConnectionSite` sur l'élément de page ou une liste vide si la page ne comporte aucun site de connexion.
`getContentAlignment()`	`ContentAlignment`	Renvoie la valeur `ContentAlignment` du texte de la forme.
`getDescription()`	`String`	Renvoie la description du texte alternatif de l'élément de page.
`getFill()`	`Fill`	Renvoie la valeur `Fill` de la forme.
`getHeight()`	`Number`	Récupère la hauteur de l'élément en points, qui correspond à la hauteur de la boîte englobante de l'élément lorsque n'a pas de rotation.
`getInherentHeight()`	`Number`	Renvoie la hauteur inhérente à l'élément en points.
`getInherentWidth()`	`Number`	Renvoie la largeur inhérente à 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 lorsque l'élément n'a pas de rotation.
`getLink()`	`Link`	Renvoie `Link` ou `null` en l'absence de lien.
`getObjectId()`	`String`	Renvoie l'identifiant unique de cet objet.
`getPageElementType()`	`PageElementType`	Renvoie le type de l'élément de page, représenté sous forme d'énumération `PageElementType`.
`getParentGroup()`	`Group`	Affiche le groupe auquel appartient cet élément de page, ou `null` si l'élément ne se trouve pas dans une groupe.
`getParentPage()`	`Page`	Affiche 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 d'espace réservé de la forme.
`getPlaceholderType()`	`PlaceholderType`	Renvoie le type d'espace réservé de la forme, ou `PlaceholderType.NONE` si elle 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és signifie pas de rotation.
`getShapeType()`	`ShapeType`	Renvoie le type de la forme.
`getText()`	`TextRange`	Affiche le contenu textuel de la forme.
`getTitle()`	`String`	Affiche 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 de l'angle supérieur gauche de la page. lorsque l'élément n'a pas de 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 du cadre de délimitation de l'élément lorsque l'élément n'a pas de rotation.
`preconcatenateTransform(transform)`	`Shape`	Préconcatène la transformation fournie dans la transformation existante de l'élément de page.
`remove()`	`void`	Supprime l'élément de page.
`removeLink()`	`void`	Supprime un élément `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 l'image d'un graphique Google Sheets.
`scaleHeight(ratio)`	`Shape`	Met à l'échelle la hauteur de l'élément en fonction du ratio spécifié.
`scaleWidth(ratio)`	`Shape`	Met à l'échelle la largeur de l'élément selon le ratio spécifié.
`select()`	`void`	Sélectionne uniquement les `PageElement` dans la présentation active et supprime tous les éléments précédents de votre choix.
`select(replace)`	`void`	Sélectionne le `PageElement` dans la présentation active.
`sendBackward()`	`Shape`	Déplace l'élément de page d'un élément vers l'arrière.
`sendToBack()`	`Shape`	Envoie l'élément de page vers le bas de la page.
`setContentAlignment(contentAlignment)`	`Shape`	Définit le `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 son cadre de délimitation lorsque n'a pas de rotation.
`setLeft(left)`	`Shape`	Définit la position horizontale de l'élément en points, mesurée à partir de l'angle supérieur gauche de la lorsque l'élément n'a pas de rotation.
`setLinkSlide(slideIndex)`	`Link`	Définit un `Link` sur la `Slide` donnée à l'aide de l'index de base zéro de la diapositive.
`setLinkSlide(slide)`	`Link`	Définit un `Link` sur le `Slide` donné, le lien est défini par l'ID de la diapositive donné.
`setLinkSlide(slidePosition)`	`Link`	Définit un `Link` sur le `Slide` donné en utilisant la position relative de la diapositive.
`setLinkUrl(url)`	`Link`	Définit un `Link` sur la chaîne d'URL non vide fournie.
`setRotation(angle)`	`Shape`	Définit l'angle de rotation de l'élément autour de son centre, en degrés, dans le sens des aiguilles d'une montre.
`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 de l'angle supérieur gauche de la page. lorsque l'élément n'a pas de 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 son cadre de délimitation lorsque n'a pas de 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 sur la page.

Renvois

Shape : cet élément de page, pour l'enchaînement.

`bringForward()`

Met en avant l'élément d'un élément sur la page.

L'élément de page ne doit pas faire partie d'un groupe.

Renvois

Shape : cet élément de page, pour l'enchaînement.

Autorisation

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

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

`bringToFront()`

Affiche l'élément de page au début de la page.

L'élément de page ne doit pas faire partie d'un groupe.

Renvois

Shape : cet élément de page, pour l'enchaînement.

Autorisation

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

Renvois

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

Autorisation

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

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

`getAutofit()`

Renvoie la valeur Autofit du texte contenu dans cette forme. Cette valeur est null si la forme n'autorise pas l'utilisation de texte.

Renvois

Autofit : ajustement automatique du texte dans cette forme.

Autorisation

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

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

`getBorder()`

Renvoie la valeur 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 correspondant à 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 valeurs ConnectionSite sur l'élément de page ou une liste vide si la 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 correspondant à un ou plusieurs des champs d'application suivants:

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

`getContentAlignment()`

Renvoie la valeur ContentAlignment du texte de la forme.

Renvois

ContentAlignment : alignement du texte dans cette forme.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 un texte alternatif.

Renvois

String : texte alternatif descriptif de l'élément de page.

Autorisation

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

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

`getFill()`

Renvoie la valeur 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 correspondant à 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 boîte englobante de l'élément lorsque n'a pas de 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 compatible avec cette méthode, reportez-vous à la les limites de taille et de positionnement.

Renvois

Number : hauteur inhérente à l'élément de page en points, ou null si l'élément de page le fait n'ont pas de hauteur.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 à l'élément en points.

La transformation de l'élément de page dépend de sa taille inhérente. Utilisez la taille inhérente dans conjointement avec la transformation de l'élément pour déterminer son apparence visuelle finale.

Renvois

Number : hauteur inhérente à l'élément de page en points, ou null si l'élément de page le fait n'ont pas de hauteur.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 à l'élément en points.

Renvois

Number : largeur inhérente à l'élément de page en points, ou null si l'élément de page le fait n'ont pas de largeur.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 lorsque l'élément n'a pas de 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 correspondant à 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 en l'absence de lien.

var link = shape.getLink();
if (link != null) {
  Logger.log('Shape has a link of type: ' + link.getLinkType());
}

Renvois

Link

Autorisation

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

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

`getObjectId()`

Renvoie l'identifiant unique de cet objet. Les ID d'objet utilisés par les pages et les éléments de page partagent le dans 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 correspondant à 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 forme d'énumération PageElementType.

Renvois

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

Autorisation

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

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

`getParentGroup()`

Affiche le groupe auquel appartient cet élément de page, ou null si l'élément ne se trouve pas dans une 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 correspondant à un ou plusieurs des champs d'application suivants:

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

`getParentPage()`

Affiche 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 correspondant à 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 ou sans 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 correspondant à 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 d'espace réservé de la forme. Si deux instances ou plus du même espace réservé sont présents sur la même page, ils ont chacun leur propre valeur d'index unique. Renvoie null si la forme n'est pas un espace réservé.

Renvois

Integer : index d'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 correspondant à 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 elle 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 correspondant à 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és signifie pas de 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 correspondant à 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()`

Affiche le contenu textuel de la forme.

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

Renvois

TextRange : contenu textuel de cette forme.

Autorisation

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

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

`getTitle()`

Affiche le titre du texte alternatif de l'élément de page. Le titre est combiné à la description pour afficher et lire un 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 correspondant à 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 de l'angle supérieur gauche de la page. lorsque l'élément n'a pas de rotation.

Renvois

Number : position verticale 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 correspondant à 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. À calculer la transformation absolue, préconcaténer 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 correspondant à 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 du cadre de délimitation de l'élément lorsque l'élément n'a pas de rotation.

Renvois

Number : largeur inhérente à l'élément de page en points, ou null si l'élément de page le fait n'ont pas de largeur.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 dans la transformation existante de l'élément de page.

newTransform = argument * existingTransform

Par exemple, pour déplacer des éléments de page de 36 points vers la gauche:

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 l'enchaînement.

Autorisation

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

Si, après une opération de suppression, une Group ne contient qu'un ou aucun élément de page, le le groupe lui-même est également supprimé.

Si un espace réservé PageElement est supprimé d'un maître ou d'une mise en page, tout élément vide héritant les espaces réservés sont également supprimés.

Autorisation

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

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

`removeLink()`

Supprime un élément Link.

shape.removeLink();

`replaceWithImage(blobSource)`

Remplace cette forme par une image fournie par un BlobSource.

L'image est extraite de l'élément BlobSource fourni une fois au moment de l'insertion et une copie est stockée pour être affichée dans la présentation. La taille des images ne doit pas dépasser 50 Mo dépasse 25 mégapixels et doit être au format PNG, JPEG ou GIF.

Afin de conserver ses proportions, l'image est mise à l'échelle et centrée par rapport au à celle de la forme existante.

var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
var driveImage = DriveApp.getFileById(fileId);
shape.replaceWithImage(driveImage);

Paramètres

Nom	Type	Description
`blobSource`	`BlobSource`	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 correspondant à 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.

Lorsque vous insérez l'image, elle est récupérée à partir de BlobSource une seule fois, et une copie est stockée pour à afficher dans la présentation. La taille des images doit être inférieure à 50 Mo et ne doit pas dépasser 25 et doivent être au format PNG, JPEG ou GIF.

var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
var driveImage = DriveApp.getFileById(fileId);
// Replace and crop the replaced image.
shape.replaceWithImage(driveImage, true);

Paramètres

Nom	Type	Description
`blobSource`	`BlobSource`	Données de l'image.
`crop`	`Boolean`	Si la valeur est `true`, l'image est recadrée pour l'adapter à la forme existante. Dans le cas contraire, 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 correspondant à 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 l'image est insérée, elle est récupérée à partir de l'URL une fois. Une copie est stockée pour être affichée dans la présentation. Les images ne doivent pas dépasser 50 Mo, ne doivent pas dépasser 25 mégapixels et doivent au format PNG, JPEG ou GIF.

L'URL fournie doit être accessible publiquement et ne doit pas dépasser 2 Ko. L'URL elle-même est enregistrée avec l'image et exposée via Image.getSourceUrl().

Afin de conserver ses proportions, l'image est mise à l'échelle et centrée par rapport au à celle de la forme existante.

Paramètres

Nom	Type	Description
`imageUrl`	`String`	URL de l'image à partir de laquelle télécharger l'image.

Renvois

Image : Image qui a remplacé la forme.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 exposées via Image.getSourceUrl().

Paramètres

Nom	Type	Description
`imageUrl`	`String`	URL de l'image à partir de laquelle télécharger l'image.
`crop`	`Boolean`	Si la valeur est `true`, l'image est recadrée pour l'adapter à la forme existante. Dans le cas contraire, 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 correspondant à 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 lié au graphique Google Sheets source, ce qui permet de le mettre à jour. Autre les collaborateurs peuvent voir le lien vers la feuille de calcul source.

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart.
var 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 correspondant à 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 l'image d'un graphique Google Sheets.

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

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

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart as an image.
var 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 correspondant à un ou plusieurs des champs d'application suivants:

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

`scaleHeight(ratio)`

Met à l'échelle la hauteur de l'élément en fonction du ratio spécifié. La hauteur de l'élément correspond à la hauteur cadre de délimitation lorsque l'élément n'a pas de rotation.

Paramètres

Nom	Type	Description
`ratio`	`Number`	Ratio utilisé pour mettre à l'échelle la hauteur de cet élément de page.

Renvois

Shape : cet élément de page, pour l'enchaînement.

Autorisation

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

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

`scaleWidth(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 délimitation lorsque l'élément n'a pas de rotation.

Paramètres

Nom	Type	Description
`ratio`	`Number`	Ratio utilisé pour mettre à l'échelle la largeur de cet élément de page.

Renvois

Shape : cet élément de page, pour l'enchaînement.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 les PageElement dans la présentation active et supprime tous les éléments précédents de votre choix. 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 seulement si le script est lié à la présentation.

Cela définit le Page parent de PageElement comme current page selection.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var 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 correspondant à 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 seulement si le script est lié à la présentation.

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

Transmettez false pour sélectionner plusieurs objets PageElement. 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 false :

Le Page parent de l'objet PageElement doit être l'current page selection.
Vous ne devez pas sélectionner plusieurs objets Page.

Pour ce faire, nous vous recommandons de sélectionner le Page parent. commencez par utiliser Page.selectAsCurrentPage(), puis sélectionnez les éléments de cette page.

var 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.
var pageElements = slide.getPageElements();
for (var 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, est ajoutée à toute sélection précédente.

Autorisation

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

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

`sendBackward()`

Déplace l'élément de page d'un élément vers l'arrière.

L'élément de page ne doit pas faire partie d'un groupe.

Renvois

Shape : cet élément de page, pour l'enchaînement.

Autorisation

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

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

`sendToBack()`

Envoie l'élément de page vers le bas de la page.

L'élément de page ne doit pas faire partie d'un groupe.

Renvois

Shape : cet élément de page, pour l'enchaînement.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 le 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 : forme utilisée pour le chaînage.

Autorisation

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

Cette 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".
var 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 à utiliser pour la description du texte alternatif.

Renvois

Shape : cet élément de page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 son cadre de délimitation lorsque n'a pas de rotation.

Paramètres

Nom	Type	Description
`height`	`Number`	Nouvelle hauteur à définir pour cet élément de page, en points.

Renvois

Shape : cet élément de page, pour l'enchaînement.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 de l'angle supérieur gauche de la lorsque l'élément n'a pas de rotation.

Paramètres

Nom	Type	Description
`left`	`Number`	Nouvelle position horizontale à définir, en points.

Renvois

Shape : cet élément de page, pour l'enchaînement.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 la Slide donnée à l'aide de l'index de base zéro de la diapositive.

// Set a link to the first slide of the presentation.
shape.setLinkSlide(0);

Paramètres

Nom	Type	Description
`slideIndex`	`Integer`	L'indice basé sur zéro à la diapositive.

Renvois

Link : Link qui a été défini

Autorisation

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

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

`setLinkSlide(slide)`

Définit un Link sur le Slide donné, le lien est défini par l'ID de la diapositive donné.

// Set a link to the first slide of the presentation.
var slide = presentation.getSlides()[0];
shape.setLinkSlide(slide);

Paramètres

Nom	Type	Description
`slide`	`Slide`	`Slide` à associer.

Renvois

Link : Link qui a été défini

Autorisation

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

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

`setLinkSlide(slidePosition)`

Définit un Link sur le Slide donné en utilisant la position relative de la diapositive.

// Set a link to the first slide of the presentation.
shape.setLinkSlide(SlideApp.SlidePosition.FIRST_SLIDE);

Paramètres

Nom	Type	Description
`slidePosition`	`SlidePosition`	La valeur `SlidePosition` relative.

Renvois

Link : Link qui a été défini

Autorisation

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

// Set a link to the URL.
shape.setLinkUrl("https://slides.google.com");

Paramètres

Nom	Type	Description
`url`	`String`	Chaîne de l'URL.

Renvois

Link : Link qui a été défini

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 autour de son centre, en degrés, dans le sens des aiguilles d'une montre.

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 l'enchaînement.

Autorisation

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

Cette 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".
var 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 sur laquelle le titre du texte alternatif doit être défini.

Renvois

Shape : cet élément de page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 de l'angle supérieur gauche de la page. lorsque l'élément n'a pas de rotation.

Paramètres

Nom	Type	Description
`top`	`Number`	Nouvelle position verticale à définir, en points.

Renvois

Shape : cet élément de page, pour l'enchaînement.

Autorisation

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

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 appartenant à un groupe modifie uniquement la transformation de cet élément de page ; il n'affecte pas les transformations du groupe ou des autres éléments de la page groupe.

Pour en savoir plus sur l'impact des transformations sur l'apparence visuelle des éléments de la page, consultez getTransform().

Paramètres

Nom	Type	Description
`transform`	`AffineTransform`	Transformation définie pour cet élément de page.

Renvois

Shape : élément utilisé pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 son cadre de délimitation lorsque n'a pas de rotation.

Paramètres

Nom	Type	Description
`width`	`Number`	Nouvelle largeur en points de cet élément de page à définir.

Renvois

Shape : cet élément de page, pour l'enchaînement.

Autorisation

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

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