PageElement
représentant une image.
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
alignOnPage(alignmentPosition) | Image | Aligne l'élément sur la position d'alignement spécifiée sur la page. |
bringForward() | Image | Met en avant l'élément d'un élément sur la page. |
bringToFront() | Image | Affiche l'élément de page au début de la page. |
duplicate() | PageElement | Duplique l'élément de page. |
getAs(contentType) | Blob | Renvoyez les données contenues dans cet objet sous forme de blob converti dans le type de contenu spécifié. |
getBlob() | Blob | Renvoyez les données contenues dans cette image sous forme de blob. |
getBorder() | Border | Renvoie l'élément Border de l'image. |
getConnectionSites() | ConnectionSite[] | Renvoie la liste des ConnectionSite sur l'élément de page ou une liste vide si l'élément de page n'a aucun site de connexion. |
getContentUrl() | String | Récupère une URL de l'image. |
getDescription() | String | Affiche la description du texte alternatif de l'élément de page. |
getHeight() | Number | Récupère la hauteur de l'élément en points, qui correspond à la hauteur du cadre de délimitation de l'élément lorsque celui-ci 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 page 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 | 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 | 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 de l'image de l'espace réservé. |
getPlaceholderType() | PlaceholderType | Renvoie le type d'espace réservé de l'image, 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. 0 degré indique qu'il n'y a pas de rotation. |
getSourceUrl() | String | Récupère l'URL source de l'image, si elle est disponible. |
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 de son cadre de délimitation lorsqu'il n'a pas de rotation. |
preconcatenateTransform(transform) | Image | 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 . |
replace(blobSource) | Image | Remplace cette image par une image décrite par un objet BlobSource . |
replace(blobSource, crop) | Image | Remplace cette image par une image décrite par un objet Image , en la recadrant si nécessaire. |
replace(imageUrl) | Image | Remplace cette image par une autre image téléchargée à partir de l'URL fournie. |
replace(imageUrl, crop) | Image | Remplace cette image par une autre image téléchargée à partir de l'URL fournie, en la recadrant si nécessaire. |
scaleHeight(ratio) | Image | Met à l'échelle la hauteur de l'élément en fonction du ratio spécifié. |
scaleWidth(ratio) | Image | Met à l'échelle la largeur de l'élément selon le ratio 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() | Image | Déplace l'élément de page d'un élément vers l'arrière. |
sendToBack() | Image | Envoie l'élément de page vers le bas de la page. |
setDescription(description) | Image | Définit la description du texte alternatif de l'élément de page. |
setHeight(height) | Image | Définit la hauteur de l'élément en points, qui correspond à la hauteur du cadre de délimitation de l'élément lorsque celui-ci n'a pas de rotation. |
setLeft(left) | Image | 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. |
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) | Image | 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) | Image | Définit le titre du texte alternatif de l'élément de page. |
setTop(top) | Image | 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) | Image | Définit la transformation de l'élément de page avec la transformation fournie. |
setWidth(width) | Image | Définit la largeur de l'élément en points, qui correspond à la largeur du cadre de délimitation de l'élément lorsque celui-ci 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
Image
: 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
Image
: 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
Image
: 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
getAs(contentType)
Renvoyez les données contenues dans cet objet sous forme de blob converti dans le type de contenu spécifié. Cette méthode ajoute l'extension appropriée au nom du fichier, par exemple "myfile.pdf". Toutefois, nous partons du principe que la partie du nom de fichier qui suit le dernier point (le cas échéant) est une extension existante qui doit être remplacée. Par conséquent, "ShoppingList.12.25.2014" devient "ShoppingList.12.25.pdf".
Pour afficher les quotas quotidiens de conversions, consultez la section Quotas pour les services Google. Les domaines Google Workspace nouvellement créés peuvent être temporairement soumis à des quotas plus stricts.
Paramètres
Nom | Type | Description |
---|---|---|
contentType | String | Type MIME vers lequel effectuer la conversion. Pour la plupart des blobs, 'application/pdf' est la seule option valide. Pour les images au format BMP, GIF, JPEG ou PNG, les valeurs 'image/bmp' , 'image/gif' , 'image/jpeg' ou 'image/png' sont également valides. |
Renvois
Blob
: données sous forme de blob.
getBlob()
Renvoyez les données contenues dans cette image sous forme de blob.
Renvois
Blob
: données d'image sous forme de blob.
getBorder()
Renvoie l'élément Border
de l'image.
Renvois
Border
: bordure de l'image.
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 ConnectionSite
sur l'élément de page ou une liste vide si l'élément de page n'a 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
getContentUrl()
Récupère une URL de l'image.
Cette URL est taguée avec le compte du demandeur. Par conséquent, toute personne disposant de l'URL accède effectivement à l'image en tant que demandeur d'origine. L'accès à l'image peut être perdu si les paramètres de partage de la présentation sont modifiés. L'URL renvoyée expire après une courte période.
Renvois
String
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()
Affiche 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
: 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
getHeight()
Récupère la hauteur de l'élément en points, qui correspond à la hauteur du cadre de délimitation de l'élément lorsque celui-ci 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 compatibles avec cette méthode, consultez 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 n'a 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 conjointement à 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 n'a 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.
La transformation de l'élément de page dépend de sa taille inhérente. Utilisez la taille inhérente conjointement à la transformation de l'élément pour déterminer son apparence visuelle finale.
Renvois
Number
: largeur inhérente à 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 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 page 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
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 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()
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 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 l'image n'est pas un espace réservé ou n'a pas de parent.
Renvois
PageElement
: élément de page parent de cet espace réservé d'image, ou null
si cette image 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 de l'image de l'espace réservé. Si deux images d'espace réservé ou plus sur la même page sont du même type, elles ont chacune une valeur d'index unique. Renvoie null
si l'image n'est pas un espace réservé.
Renvois
Integer
: index d'espace réservé de cette image ou null
si l'image 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 l'image, ou PlaceholderType.NONE
si la forme n'est pas un espace réservé.
Renvois
PlaceholderType
: type d'espace réservé de cette image.
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. 0 degré indique qu'il n'y a 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
getSourceUrl()
Récupère l'URL source de l'image, si elle est disponible.
Lorsqu'une image est insérée par l'URL, renvoie l'URL fournie lors de l'insertion de l'image.
Renvois
String
: URL de l'image ou null
si l'image n'a pas d'URL source.
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 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 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. 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 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 de son cadre de délimitation lorsqu'il 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 compatibles avec cette méthode, consultez les limites de taille et de positionnement.
Renvois
Number
: largeur inhérente à 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 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
Image
: 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, un Group
ne contient qu'un ou aucun élément de page, 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 vides 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();
replace(blobSource)
Remplace cette image par une image décrite par un objet BlobSource
.
Lorsque vous insérez l'image, elle est récupérée à partir de
BlobSource
une seule fois. Une copie est stockée pour être affichée dans la présentation.
Les images doivent être au format PNG, JPEG ou GIF, et ne doivent pas dépasser 25 mégapixels et leur taille doit être inférieure à 50 Mo.
Afin de conserver ses proportions, l'image est mise à l'échelle et centrée par rapport à la taille de l'image existante.
var image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0]; // Get the Drive image file with the given ID. var driveImage = DriveApp.getFileById(fileId); image.replace(driveImage);
Paramètres
Nom | Type | Description |
---|---|---|
blobSource | BlobSource | Données de l'image. |
Renvois
Image
: Image
après le remplacement.
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
replace(blobSource, crop)
Remplace cette image par une image décrite par un objet Image
, en la recadrant si nécessaire.
Lorsque vous insérez l'image, elle est récupérée à partir de
BlobSource
une seule fois. Une copie est stockée pour être affichée dans la présentation.
Les images doivent être au format PNG, JPEG ou GIF, et ne doivent pas dépasser 25 mégapixels et leur taille doit être inférieure à 50 Mo.
var image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0]; // Get the Drive image file with the given ID. var driveImage = DriveApp.getFileById(fileId); // Replace and crop the drive image. image.replace(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 taille de l'image existante. Sinon, l'image est mise à l'échelle et centrée. |
Renvois
Image
: Image
après le remplacement.
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
replace(imageUrl)
Remplace cette image par une autre image téléchargée à partir de l'URL fournie.
Lorsque vous insérez l'image, 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 ê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 exposée via getSourceUrl()
.
Afin de conserver ses proportions, l'image est mise à l'échelle et centrée par rapport à la taille de l'image existante.
Paramètres
Nom | Type | Description |
---|---|---|
imageUrl | String | URL à partir de laquelle télécharger l'image. |
Renvois
Image
: Image
après le remplacement.
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
replace(imageUrl, crop)
Remplace cette image par une autre image téléchargée à partir de l'URL fournie, en la recadrant si nécessaire.
Lorsque vous insérez l'image, 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 être au format PNG, JPEG ou GIF.
L'URL fournie ne doit pas dépasser 2 Ko.
Paramètres
Nom | Type | Description |
---|---|---|
imageUrl | String | URL à partir de laquelle télécharger l'image. |
crop | Boolean | Si la valeur est true , l'image est recadrée pour l'adapter à la taille de l'image existante. Sinon, l'image est mise à l'échelle et centrée. |
Renvois
Image
: Image
après le remplacement.
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 de son cadre de délimitation lorsqu'il 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 compatibles avec cette méthode, consultez les limites de taille et de positionnement.
Paramètres
Nom | Type | Description |
---|---|---|
ratio | Number | Ratio utilisé pour mettre à l'échelle la hauteur de cet élément de page. |
Renvois
Image
: 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 lorsqu'il 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 compatibles avec cette méthode, consultez les limites de taille et de positionnement.
Paramètres
Nom | Type | Description |
---|---|---|
ratio | Number | Ratio utilisé pour mettre à l'échelle la largeur de cet élément de page. |
Renvois
Image
: 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 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 seulement 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 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 s'il est lié à la présentation.
Transmettez true
à cette méthode pour ne sélectionner que la PageElement
et supprimer 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
:
- Le
Page
parent de l'objetPageElement
doit être l'current page selection
. - Vous ne devez pas sélectionner plusieurs objets
Page
.
Pour vous en assurer, nous vous recommandons de sélectionner d'abord le Page
parent à l'aide de Page.selectAsCurrentPage()
, puis de sélectionner les éléments de la page sur 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, elle 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
Image
: 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
Image
: 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
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
Image
: 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 du cadre de délimitation de l'élément lorsque celui-ci 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 compatibles avec cette méthode, consultez les limites de taille et de positionnement.
Paramètres
Nom | Type | Description |
---|---|---|
height | Number | Nouvelle hauteur à définir pour cet élément de page, en points. |
Renvois
Image
: 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 page lorsque l'élément n'a pas de rotation.
Paramètres
Nom | Type | Description |
---|---|---|
left | Number | Nouvelle position horizontale à définir, en points. |
Renvois
Image
: 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
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
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
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
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.
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 taille et de positionnement.
Paramètres
Nom | Type | Description |
---|---|---|
angle | Number | Nouvel angle de rotation dans le sens des aiguilles d'une montre à définir, en degrés. |
Renvois
Image
: 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
Image
: 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
Image
: 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 de ce groupe, ce qui peut modifier leur apparence visuelle.
La mise à jour de la transformation d'un élément de page qui se trouve dans un groupe modifie uniquement la transformation de cet élément de page. Cela n'a aucune incidence sur les transformations du groupe ou des autres éléments de la 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
Nom | Type | Description |
---|---|---|
transform | AffineTransform | Transformation définie pour cet élément de page. |
Renvois
Image
: é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 du cadre de délimitation de l'élément lorsque celui-ci 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 compatibles avec cette méthode, consultez les limites de taille et de positionnement.
Paramètres
Nom | Type | Description |
---|---|---|
width | Number | Nouvelle largeur en points de cet élément de page à définir. |
Renvois
Image
: 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