Class Shape

Forme

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éthodeType renvoyéBrève description
alignOnPage(alignmentPosition)ShapeAligne l'élément sur la position d'alignement spécifiée sur la page.
bringForward()ShapeDéplace l'élément de page sur un seul élément de la page.
bringToFront()ShapeMet l'élément de page au premier plan.
duplicate()PageElementDupliquer l'élément de page.
getAutofit()AutofitRenvoie le Autofit du texte dans cette forme.
getBorder()BorderRenvoie le Border de la forme.
getConnectionSites()ConnectionSite[]Renvoie la liste de ConnectionSite sur l'élément de page ou une liste vide si l'élément de page ne comporte aucun site de connexion.
getContentAlignment()ContentAlignmentRenvoie le ContentAlignment du texte dans la forme.
getDescription()StringRenvoie la description du texte alternatif de l'élément de page.
getFill()FillRenvoie le Fill de la forme.
getHeight()NumberObtient la hauteur de l'élément en points, qui correspond à la hauteur du cadre de délimitation de l'élément lorsque l'élément n'a pas de rotation.
getInherentHeight()NumberRenvoie la hauteur inhérente de l'élément (en points).
getInherentWidth()NumberRenvoie la largeur intrinsèque de l'élément (en points).
getLeft()NumberRenvoie 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'a pas de rotation.
getLink()LinkRenvoie Link ou null s'il n'y a pas de lien.
getObjectId()StringRenvoie l'ID unique pour cet objet.
getPageElementType()PageElementTypeRenvoie le type de l'élément de page, représenté sous la forme d'une énumération PageElementType.
getParentGroup()GroupRenvoie le groupe auquel appartient cet élément de page ou null si l'élément ne fait pas partie d'un groupe.
getParentPage()PageAffiche la page sur laquelle se trouve cet élément.
getParentPlaceholder()PageElementRenvoie l'élément de page parent de l'espace réservé.
getPlaceholderIndex()IntegerRenvoie l'index d'espace réservé de la forme.
getPlaceholderType()PlaceholderTypeRenvoie le type d'espace réservé de la forme, ou PlaceholderType.NONE si la forme n'est pas un espace réservé.
getRotation()NumberRenvoie l'angle de rotation de l'élément vers la droite autour de son centre, en degrés, où zéro degré indique une absence de rotation.
getShapeType()ShapeTypeRenvoie le type de la forme.
getText()TextRangeRenvoie le contenu textuel de la forme.
getTitle()StringRenvoie le titre alternatif du texte de l'élément de page.
getTop()NumberObtient 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()AffineTransformRenvoie la transformation de l'élément de page.
getWidth()NumberRenvoie 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)ShapePréconcaie la transformation fournie avec la transformation existante de l'élément de page.
remove()voidSupprime l'élément de page.
removeLink()voidSupprime un Link.
replaceWithImage(blobSource)ImageRemplace cette forme par une image fournie par un BlobSource.
replaceWithImage(blobSource, crop)ImageRemplace cette forme par une image fournie par un BlobSource.
replaceWithImage(imageUrl)ImageRemplace cette forme par une image.
replaceWithImage(imageUrl, crop)ImageRemplace cette forme par une image.
replaceWithSheetsChart(sourceChart)SheetsChartRemplace cette forme par un graphique Google Sheets.
replaceWithSheetsChartAsImage(sourceChart)ImageRemplace cette forme par l'image d'un graphique Google Sheets.
scaleHeight(ratio)ShapeMet à l'échelle la hauteur de l'élément selon le ratio spécifié.
scaleWidth(ratio)ShapeMet la largeur de l'élément à l'échelle en fonction du ratio spécifié.
select()voidSélectionne uniquement le PageElement dans la présentation active et supprime toute sélection précédente.
select(replace)voidSélectionne PageElement dans la présentation active.
sendBackward()ShapeRenvoyer l'élément de page sur la page d'un seul élément
sendToBack()ShapeMet l'élément de page en arrière-plan.
setContentAlignment(contentAlignment)ShapeDéfinit le ContentAlignment du texte dans la forme.
setDescription(description)ShapeDéfinit la description du texte alternatif de l'élément de page.
setHeight(height)ShapeDéfinit la hauteur de l'élément en points, qui correspond à la hauteur du cadre de délimitation de l'élément lorsque l'élément n'a pas de rotation.
setLeft(left)ShapeDé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'a pas de rotation.
setLinkSlide(slideIndex)LinkDéfinit une Link sur la Slide donnée en utilisant l'index basé sur zéro de la diapositive.
setLinkSlide(slide)LinkDéfinit un Link sur la Slide donnée, le lien est défini sur l'ID de diapositive donné.
setLinkSlide(slidePosition)LinkDéfinit un Link sur la Slide donnée en utilisant la position relative de la diapositive.
setLinkUrl(url)LinkDéfinit un Link sur la chaîne d'URL donnée non renseignée.
setRotation(angle)ShapeDéfinit l'angle de rotation de l'élément en degrés autour du centre, en degrés.
setTitle(title)ShapeDéfinit le titre du texte alternatif de l'élément de page.
setTop(top)ShapeDé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)ShapeDéfinit la transformation de l'élément de page avec la transformation fournie.
setWidth(width)ShapeDéfinit la largeur de l'élément en points, c'est-à-dire la largeur du cadre de délimitation de l'élément lorsque l'élément 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

NomTypeDescription
alignmentPositionAlignmentPositionPosition à laquelle cet élément doit aligner sur la page.

Aller-retour

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


bringForward()

Déplace l'élément de page sur un seul élément de la page.

L'élément de page ne doit pas être dans un groupe.

Aller-retour

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

Autorisation

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

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

bringToFront()

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

L'élément de page ne doit pas être dans un groupe.

Aller-retour

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

Autorisation

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

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

duplicate()

Dupliquer l'élément de page.

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

Aller-retour

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

Autorisation

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

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

getAutofit()

Renvoie le Autofit du texte dans cette forme. La valeur est null si la forme n'autorise pas le texte.

Aller-retour

Autofit : ajustement automatique du texte dans cette forme.

Autorisation

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

Aller-retour

Border : paramètre de bordure de cette forme.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation pour 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 de ConnectionSite sur l'élément de page ou une liste vide si l'élément de page ne comporte aucun site de connexion.

Aller-retour

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 pour un ou plusieurs des champs d'application suivants :

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

getContentAlignment()

Renvoie le ContentAlignment du texte dans la forme.

Aller-retour

ContentAlignment : l'alignement du texte dans cette forme.

Autorisation

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

Aller-retour

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

Autorisation

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

Aller-retour

Fill : paramètre de remplissage de cette forme.

Autorisation

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

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

getHeight()

Obtient la hauteur de l'élément en points, qui correspond à la hauteur du cadre de délimitation de l'élément lorsque l'élément 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 la page ne sont pas compatibles avec cette méthode, consultez les limites de dimensionnement et de positionnement.

Aller-retour

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 pour 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 intrinsèque avec la transformation de l'élément pour déterminer son apparence finale.

Aller-retour

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 pour 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 intrinsèque 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 avec la transformation de l'élément pour déterminer son apparence finale.

Aller-retour

Number : largeur intrinsèque de l'élément de page, 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 pour 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'a pas de rotation.

Aller-retour

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 pour un ou plusieurs des champs d'application suivants :

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

Renvoie Link ou null s'il n'y a pas de lien.

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

Aller-retour

Link

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation pour 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 pour cet objet. Les ID d'objet utilisés par les pages et les éléments de page partagent le même espace de noms.

Aller-retour

String : ID unique de l'objet.

Autorisation

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

Aller-retour

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

Autorisation

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

Aller-retour

Group : groupe auquel appartient cet élément de page, ou null

Autorisation

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

Aller-retour

Page : page sur laquelle se trouve cet élément.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation pour 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 n'a pas de parent.

Aller-retour

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 pour 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 plusieurs instances du même type d'espace réservé sont présentes sur la même page, chacune possède sa propre valeur d'index unique. Renvoie null si la forme n'est pas un espace réservé.

Aller-retour

Integer : index d'espace réservé de la 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 pour 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é.

Aller-retour

PlaceholderType : type d'espace réservé de cette forme.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation pour 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 vers la droite autour de son centre, en degrés, où zéro degré indique une absence de rotation.

Aller-retour

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

Autorisation

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

Aller-retour

ShapeType : type de la forme.


getText()

Renvoie le contenu textuel de la forme.

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

Aller-retour

TextRange : contenu textuel de cette forme.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation pour 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 alternatif du texte de l'élément de page. Le titre est associé à la description pour afficher et lire le texte alternatif.

Aller-retour

String : titre du texte alternatif de l'élément de page.

Autorisation

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

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

getTop()

Obtient 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.

Aller-retour

Number : position verticale de l'é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 pour 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, 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.

Aller-retour

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

Autorisation

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

Cette méthode n'est pas compatible avec tous les éléments de la page. Pour savoir quels éléments de la page ne sont pas compatibles avec cette méthode, consultez les limites de dimensionnement et de positionnement.

Aller-retour

Number : largeur intrinsèque de l'élément de page, 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 pour un ou plusieurs des champs d'application suivants:

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

preconcatenateTransform(transform)

Préconcaie la transformation fournie avec la transformation existante de l'élément de page.

newTransform = argument * existingTransform

Par exemple, pour déplacer un élément de page 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

NomTypeDescription
transformAffineTransformTransformation à préconcaténer avec la transformation de cet élément de page.

Aller-retour

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation pour 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, un Group ne contient qu'un seul élément de page, voire aucun, 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, tous les espaces réservés hérités hérités sont également supprimés.

Autorisation

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

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

Supprime un Link.

shape.removeLink();

replaceWithImage(blobSource)

Remplace cette forme par une image fournie par un BlobSource.

L'image est extraite de la BlobSource fournie une fois au moment de l'insertion et une copie est stockée pour l'afficher 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.

Afin de conserver les proportions, l'image est mise à l'échelle et centrée par rapport à la taille 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

NomTypeDescription
blobSourceBlobSourceDonnées d'image.

Aller-retour

Image : Image qui a remplacé la forme.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation pour 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 permet de la récupérer une fois depuis BlobSource et de stocker une copie pour l'afficher 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.

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

NomTypeDescription
blobSourceBlobSourceDonnées d'image.
cropBooleanSi la valeur est true, recadre l'image pour l'adapter à la taille de la forme existante. Sinon, l'image est mise à l'échelle et centrée.

Aller-retour

Image : Image qui a remplacé la forme.

Autorisation

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

L'insertion de l'image permet de l'extraire une seule fois à partir de l'URL et de stocker une copie pour l'afficher 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 publiquement et ne doit pas dépasser 2 Ko. L'URL elle-même est enregistrée avec l'image et diffusée via Image.getSourceUrl().

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

Paramètres

NomTypeDescription
imageUrlStringURL de l'image à partir de laquelle l'image doit être téléchargée.

Aller-retour

Image : Image qui a remplacé la forme.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation pour 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'insertion de l'image permet de l'extraire une seule fois à partir de l'URL et de stocker une copie pour l'afficher 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 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

NomTypeDescription
imageUrlStringURL de l'image à partir de laquelle l'image doit être téléchargée.
cropBooleanSi la valeur est true, recadre l'image pour l'adapter à la taille de la forme existante. Sinon, l'image est mise à l'échelle et centrée.

Aller-retour

Image : Image qui a remplacé la forme.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation pour 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 qui permet sa mise à jour. Les autres 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

NomTypeDescription
sourceChartEmbeddedChartGraphique dans une feuille de calcul qui remplace la forme.

Aller-retour

SheetsChart : graphique qui a remplacé la forme.

Autorisation

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

NomTypeDescription
sourceChartEmbeddedChartGraphique dans une feuille de calcul qui remplace la forme.

Aller-retour

Image : image du graphique qui a remplacé la forme.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation pour 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 selon le ratio spécifié. La hauteur de l'élément correspond à la hauteur de son cadre de délimitation lorsque l'élément 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 la page ne sont pas compatibles avec cette méthode, consultez les limites de dimensionnement et de positionnement.

Paramètres

NomTypeDescription
ratioNumberRatio de mise à l'échelle de la hauteur de cet élément de page.

Aller-retour

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

Autorisation

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

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

scaleWidth(ratio)

Met la largeur de l'élément à l'échelle en fonction du 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.

Cette méthode n'est pas compatible avec tous les éléments de la page. Pour savoir quels éléments de la page ne sont pas compatibles avec cette méthode, consultez les limites de dimensionnement et de positionnement.

Paramètres

NomTypeDescription
ratioNumberRatio de mise à l'échelle de la largeur de cet élément de page.

Aller-retour

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation pour 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 s'il 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 pour 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 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 s'il est lié à la présentation.

Transmettez true à cette méthode pour ne sélectionner que PageElement et supprimez toute 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. Les objets PageElement doivent se trouver dans le même Page.

Les conditions suivantes doivent être remplies lors de la sélection d'un élément de page à l'aide d'un paramètre false:

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

Pour vous assurer que c'est le cas, l'approche privilégiée consiste à sélectionner d'abord le parent Page à l'aide de Page.selectAsCurrentPage(), puis 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

NomTypeDescription
replaceBooleanSi la valeur est true, la sélection remplace toute sélection précédente. Sinon, la sélection est ajoutée à une sélection précédente.

Autorisation

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

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

sendBackward()

Renvoyer l'élément de page sur la page d'un seul élément

L'élément de page ne doit pas être dans un groupe.

Aller-retour

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation pour 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 en arrière-plan.

L'élément de page ne doit pas être dans un groupe.

Aller-retour

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

Autorisation

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

NomTypeDescription
contentAlignmentContentAlignmentAlignement à définir.

Aller-retour

Shape : forme permettant le chaînage.

Autorisation

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

NomTypeDescription
descriptionStringChaîne de caractères permettant de définir la description du texte alternatif.

Aller-retour

Shape : cet élément de page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation pour 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 du cadre de délimitation de l'élément lorsque l'élément 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 la page ne sont pas compatibles avec cette méthode, consultez les limites de dimensionnement et de positionnement.

Paramètres

NomTypeDescription
heightNumberNouvelle hauteur de cet élément de page à définir, en points.

Aller-retour

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation pour 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 page lorsque l'élément n'a pas de rotation.

Paramètres

NomTypeDescription
leftNumberNouvelle position horizontale à définir, en points.

Aller-retour

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation pour 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 une Link sur la Slide donnée en utilisant l'index basé sur zéro de la diapositive.

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

Paramètres

NomTypeDescription
slideIndexIntegerIndex basé sur zéro sur la diapositive.

Aller-retour

Link : Link défini

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation pour 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 la Slide donnée, le lien est défini sur l'ID de diapositive donné.

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

Paramètres

NomTypeDescription
slideSlideSlide à associer.

Aller-retour

Link : Link défini

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation pour 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 la Slide donnée 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

NomTypeDescription
slidePositionSlidePositionValeur SlidePosition relative.

Aller-retour

Link : Link défini

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation pour 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 donnée non renseignée.

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

Paramètres

NomTypeDescription
urlStringChaîne d'URL.

Aller-retour

Link : Link défini

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation pour 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 en degrés autour du centre, en degrés.

Cette méthode n'est pas compatible avec tous les éléments de la page. Pour savoir quels éléments de la page ne sont pas compatibles avec cette méthode, consultez les limites de dimensionnement et de positionnement.

Paramètres

NomTypeDescription
angleNumberNouvel angle de rotation vers la droite à définir, en degrés.

Aller-retour

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

Autorisation

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

NomTypeDescription
titleStringChaîne de caractères du titre alternatif.

Aller-retour

Shape : cet élément de page.

Autorisation

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

NomTypeDescription
topNumberNouvelle position verticale à définir, en points.

Aller-retour

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation pour 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 page de ce groupe, ce qui peut modifier leur apparence visuelle.

La mise à jour de la transformation d'un élément de page dans un groupe ne modifie que la transformation de cet élément de page. Elle 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 la page, consultez getTransform().

Paramètres

NomTypeDescription
transformAffineTransformTransformation définie pour cet élément de page.

Aller-retour

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation pour 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, c'est-à-dire la largeur du cadre de délimitation de l'élément lorsque l'élément 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 la page ne sont pas compatibles avec cette méthode, consultez les limites de dimensionnement et de positionnement.

Paramètres

NomTypeDescription
widthNumberNouvelle largeur de cet élément de page à définir, en points.

Aller-retour

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

Autorisation

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

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