Mise en page dans une présentation.
Chaque mise en page sert de modèle pour les diapositives qui en héritent, déterminant la façon dont le contenu ces diapositives sont organisées et stylisées.
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
getBackground() | PageBackground | Récupère l'arrière-plan de la page. |
getColorScheme() | ColorScheme | Récupère les ColorScheme associés à la page. |
getGroups() | Group[] | Affiche la liste des objets Group sur la page. |
getImages() | Image[] | Affiche la liste des objets Image sur la page. |
getLayoutName() | String | Récupère le nom de la mise en page. |
getLines() | Line[] | Affiche la liste des objets Line sur la page. |
getMaster() | Master | Récupère le maître sur lequel la mise en page est basée. |
getObjectId() | String | Récupère l'identifiant unique de la page. |
getPageElementById(id) | PageElement | Affiche le PageElement sur la page avec l'ID donné ou null s'il n'en existe aucun. |
getPageElements() | PageElement[] | Affiche la liste des objets PageElement affichés sur la page. |
getPageType() | PageType | Récupère le type de page. |
getPlaceholder(placeholderType) | PageElement | Renvoie l'objet d'espace réservé PageElement pour une valeur PlaceholderType spécifiée ou
null si aucun espace réservé correspondant n'est présent. |
getPlaceholder(placeholderType, placeholderIndex) | PageElement | Renvoie l'objet d'espace réservé PageElement pour un PlaceholderType spécifié et
un index d'espace réservé, ou null si l'espace réservé n'est pas présent. |
getPlaceholders() | PageElement[] | Affiche la liste des objets PageElement réservés sur la page. |
getShapes() | Shape[] | Affiche la liste des objets Shape sur la page. |
getSheetsCharts() | SheetsChart[] | Affiche la liste des objets SheetsChart sur la page. |
getTables() | Table[] | Affiche la liste des objets Table sur la page. |
getVideos() | Video[] | Affiche la liste des objets Video sur la page. |
getWordArts() | WordArt[] | Affiche la liste des objets WordArt sur la page. |
group(pageElements) | Group | Regroupe tous les éléments de page spécifiés. |
insertGroup(group) | Group | Insère une copie de la propriété Group fournie sur la page. |
insertImage(blobSource) | Image | Insère dans l'angle supérieur gauche de la page une image dont la taille par défaut correspond à celle blob d'image. |
insertImage(blobSource, left, top, width, height) | Image | Insère une image sur la page avec la position et la taille fournies par l'objet blob d'image spécifié. |
insertImage(image) | Image | Insère une copie de la propriété Image fournie sur la page. |
insertImage(imageUrl) | Image | Insère dans l'angle supérieur gauche de la page une image dont la taille correspond par défaut à celle de l'URL fournie. |
insertImage(imageUrl, left, top, width, height) | Image | Insère une image sur la page avec la position et la taille fournies à partir de l'URL fournie. |
insertLine(line) | Line | Insère une copie de la propriété Line fournie sur la page. |
insertLine(lineCategory, startConnectionSite, endConnectionSite) | Line | Insère une ligne sur la page reliant deux connection sites. |
insertLine(lineCategory, startLeft, startTop, endLeft, endTop) | Line | Insère une ligne sur la page. |
insertPageElement(pageElement) | PageElement | Insère une copie de la propriété PageElement fournie sur la page. |
insertShape(shape) | Shape | Insère une copie de la propriété Shape fournie sur la page. |
insertShape(shapeType) | Shape | Insère une forme sur la page. |
insertShape(shapeType, left, top, width, height) | Shape | Insère une forme sur la page. |
insertSheetsChart(sourceChart) | SheetsChart | Insère un graphique Google Sheets sur la page. |
insertSheetsChart(sourceChart, left, top, width, height) | SheetsChart | Insère sur la page un graphique Google Sheets avec la position et la taille fournies. |
insertSheetsChart(sheetsChart) | SheetsChart | Insère une copie de la propriété SheetsChart fournie sur la page. |
insertSheetsChartAsImage(sourceChart) | Image | Insère un graphique Google Sheets sur la page en tant que Image. |
insertSheetsChartAsImage(sourceChart, left, top, width, height) | Image | Insère un graphique Google Sheets sous forme de Image sur la page, avec la position indiquée et
la taille de l'image. |
insertTable(numRows, numColumns) | Table | Insère un tableau sur la page. |
insertTable(numRows, numColumns, left, top, width, height) | Table | Insère sur la page un tableau avec la position et la taille fournies. |
insertTable(table) | Table | Insère une copie de la propriété Table fournie sur la page. |
insertTextBox(text) | Shape | Insère une zone de texte Shape contenant la chaîne fournie sur la page. |
insertTextBox(text, left, top, width, height) | Shape | Insère une zone de texte Shape contenant la chaîne fournie sur la page. |
insertVideo(videoUrl) | Video | Insère une vidéo dans l'angle supérieur gauche de la page, avec une taille par défaut. |
insertVideo(videoUrl, left, top, width, height) | Video | Insère une vidéo sur la page avec la position et la taille fournies. |
insertVideo(video) | Video | Insère une copie de la propriété Video fournie sur la page. |
insertWordArt(wordArt) | WordArt | Insère une copie de la propriété WordArt fournie sur la page. |
remove() | void | Supprime la page. |
replaceAllText(findText, replaceText) | Integer | Remplace toutes les occurrences de texte correspondant au texte à rechercher par le texte de remplacement. |
replaceAllText(findText, replaceText, matchCase) | Integer | Remplace toutes les occurrences de texte correspondant au texte à rechercher par le texte de remplacement. |
selectAsCurrentPage() | void | Sélectionne le Page dans la présentation active en tant que current page selection et supprime toute sélection précédente. |
Documentation détaillée
getBackground()
Récupère l'arrière-plan de la page.
Renvois
PageBackground : arrière-plan 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
getColorScheme()
Récupère les ColorScheme associés à la page.
Renvois
ColorScheme : jeu de couleurs 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
getGroups()
Affiche la liste des objets Group sur la page.
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
getImages()
Affiche la liste des objets Image sur la page.
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
getLayoutName()
Récupère le nom de la mise en page.
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
getLines()
Affiche la liste des objets Line sur la page.
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
getMaster()
Récupère le maître sur lequel la mise en page est basée.
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()
Récupère l'identifiant unique de la page. Les ID d'objet utilisés par les pages et les éléments de page partagent les mêmes espace de noms.
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
getPageElementById(id)
Affiche le PageElement sur la page avec l'ID donné ou null s'il n'en existe aucun.
Paramètres
| Nom | Type | Description |
|---|---|---|
id | String | ID de l'élément de page en cours de récupération. |
Renvois
PageElement : élément de page ayant l'ID donné.
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
getPageElements()
Affiche la liste des objets PageElement affichés sur la page.
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
getPageType()
Récupère le type de page.
Renvois
PageType : type 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
getPlaceholder(placeholderType)
Renvoie l'objet d'espace réservé PageElement pour une valeur PlaceholderType spécifiée ou
null si aucun espace réservé correspondant n'est présent.
S'il existe plusieurs espaces réservés du même type, il renvoie celui avec le minimum index d'espace réservé. S'il existe plusieurs espaces réservés correspondants avec le même index, la méthode renvoie le premier espace réservé de la collection d'éléments de page de la page.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE);
Paramètres
| Nom | Type | Description |
|---|---|---|
placeholderType | PlaceholderType |
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
getPlaceholder(placeholderType, placeholderIndex)
Renvoie l'objet d'espace réservé PageElement pour un PlaceholderType spécifié et
un index d'espace réservé, ou null si l'espace réservé n'est pas présent.
S'il existe plusieurs espaces réservés avec le même type et le même index, la première valeur dans la collection d'éléments de page de la page.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE, 0);
Paramètres
| Nom | Type | Description |
|---|---|---|
placeholderType | PlaceholderType | |
placeholderIndex | Integer |
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
getPlaceholders()
Affiche la liste des objets PageElement réservés sur la page.
var master = SlidesApp.getActivePresentation().getMasters()[0];
Logger.log('Number of placeholders in the master: ' + master.getPlaceholders().length);
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
getShapes()
Affiche la liste des objets Shape sur la page.
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
getSheetsCharts()
Affiche la liste des objets SheetsChart sur la page.
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
getTables()
Affiche la liste des objets Table sur la page.
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
getVideos()
Affiche la liste des objets Video sur la page.
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
getWordArts()
Affiche la liste des objets WordArt sur la page.
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
group(pageElements)
Regroupe tous les éléments de page spécifiés.
Il doit y avoir au moins deux éléments de page sur une même page qui ne se trouvent pas déjà dans une autre
groupe. Certains éléments de page, tels que Videos, Tables et placeholder Shapes, ne peuvent pas être regroupés.
Paramètres
| Nom | Type | Description |
|---|---|---|
pageElements | PageElement[] | Éléments à regrouper. |
Renvois
Group : nouveau groupe.
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
insertGroup(group)
Insère une copie de la propriété Group fournie sur la page.
La position de l'élément inséré sur cette page est déterminée par la balise sur sa page respective.
Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, Les propriétés qui héritent des pages maîtres ou des pages de mise en page héritent également de l'élément inséré.
Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, Les propriétés qui héritent des pages maîtres ou des pages de mise en page sont copiées dans l'élément à partir de la source. présentation.
// Copy a group between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var group = otherPresentationSlide.getGroups()[0];
currentPresentationSlide.insertGroup(group); // Also available for Layout, Master, and Page.
Paramètres
| Nom | Type | Description |
|---|---|---|
group | Group | Groupe à copier et à insérer. |
Renvois
Group : groupe inséré.
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
insertImage(blobSource)
Insère dans l'angle supérieur gauche de la page une image dont la taille par défaut correspond à celle blob d'image.
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 slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. var image = DriveApp.getFileById(fileId); slide.insertImage(image);
Paramètres
| Nom | Type | Description |
|---|---|---|
blobSource | BlobSource | Données de l'image. |
Renvois
Image : image insérée.
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
insertImage(blobSource, left, top, width, height)
Insère une image sur la page avec la position et la taille fournies par l'objet blob d'image spécifié.
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 à la taille indiquée.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
var image = DriveApp.getFileById(fileId);
var position = {left: 0, top: 0};
var size = {width: 300, height: 100};
slide.insertImage(image, position.left, position.top, size.width, size.height);
Paramètres
| Nom | Type | Description |
|---|---|---|
blobSource | BlobSource | Données de l'image. |
left | Number | Position horizontale de l'image en points, mesurée à partir de l'angle supérieur gauche de la page. |
top | Number | Position verticale de l'image en points, mesurée à partir de l'angle supérieur gauche de la page. |
width | Number | Largeur de l'image en points. |
height | Number | Hauteur de l'image en points. |
Renvois
Image : image insérée.
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
insertImage(image)
Insère une copie de la propriété Image fournie sur la page.
La position des images insérées sur cette page est déterminée à partir de la position de l'image source. sur leur page respective.
Si l'image fournie est un espace réservé copié à partir de la présentation actuelle, Les propriétés qui héritent des pages maîtres ou des pages de mise en page héritent également de l'image insérée.
Si l'image fournie est un espace réservé copié à partir d'une autre présentation, Les propriétés qui héritent des pages maîtres ou des pages de mise en page sont copiées sur l'image à partir de la source. présentation. Si l'image de remplacement copiée est vide, rien n'est inséré dans la destination présentation.
// Copy an image between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var image = otherPresentationSlide.getImages[0];
currentPresentationSlide.insertImage(image);
Paramètres
| Nom | Type | Description |
|---|---|---|
image | Image | Image à copier et à insérer. |
Renvois
Image : image insérée.
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
insertImage(imageUrl)
Insère dans l'angle supérieur gauche de la page une image dont la taille correspond par défaut à celle de l'URL fournie.
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().
Paramètres
| Nom | Type | Description |
|---|---|---|
imageUrl | String | URL de l'image. |
Renvois
Image : image insérée.
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
insertImage(imageUrl, left, top, width, height)
Insère une image sur la page avec la position et la taille fournies à partir de l'URL fournie.
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 à la taille indiquée.
Paramètres
| Nom | Type | Description |
|---|---|---|
imageUrl | String | URL de l'image. |
left | Number | Position horizontale de l'image en points, mesurée à partir de l'angle supérieur gauche de la page. |
top | Number | Position verticale de l'image en points, mesurée à partir de l'angle supérieur gauche de la page. |
width | Number | Largeur de l'image en points. |
height | Number | Hauteur de l'image en points. |
Renvois
Image : image insérée.
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
insertLine(line)
Insère une copie de la propriété Line fournie sur la page.
La position de l'élément inséré sur cette page est déterminée par la balise sur sa page respective.
Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, Les propriétés qui héritent des pages maîtres ou des pages de mise en page héritent également de l'élément inséré.
Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, Les propriétés qui héritent des pages maîtres ou des pages de mise en page sont copiées dans l'élément à partir de la source. présentation.
// Copy a line between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var line = otherPresentationSlide.getLines[0];
currentPresentationSlide.insertLine(line);
Paramètres
| Nom | Type | Description |
|---|---|---|
line | Line | Ligne à copier et à insérer. |
Renvois
Line : ligne insérée.
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
insertLine(lineCategory, startConnectionSite, endConnectionSite)
Insère une ligne sur la page reliant deux connection sites. Les deux
sites de connexion doivent figurer sur cette page.
// Insert a line in the first slide of the presentation connecting two shapes.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
var shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD);
slide.insertLine(
SlidesApp.LineCategory.BENT,
shape1.getConnectionSites()[0],
shape2.getConnectionSites()[1]);
Paramètres
| Nom | Type | Description |
|---|---|---|
lineCategory | LineCategory | Catégorie de la ligne à insérer. |
startConnectionSite | ConnectionSite | Le site de connexion où le début de la ligne doit être connecté. |
endConnectionSite | ConnectionSite | Le site de connexion où l'extrémité de la ligne doit être connectée. |
Renvois
Line : ligne insérée.
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
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)
Insère une ligne sur la page.
// Insert a line in the first slide of the presentation.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var startPoint = {left: 10, top: 10};
var endPoint = {left: 40, top: 40};
slide.insertLine(
SlidesApp.LineCategory.STRAIGHT,
startPoint.left,
startPoint.top,
endPoint.left,
endPoint.top);
Paramètres
| Nom | Type | Description |
|---|---|---|
lineCategory | LineCategory | Catégorie de la ligne à insérer. |
startLeft | Number | Position horizontale du point de départ de la ligne, mesurée en points en haut à gauche de la page. |
startTop | Number | Position verticale du point de départ de la ligne, mesurée en points depuis dans le coin supérieur gauche de la page. |
endLeft | Number | La position horizontale du point d'arrivée de la ligne, mesurée en points depuis dans le coin supérieur gauche de la page. |
endTop | Number | Position verticale du point d'arrivée de la ligne, mesurée en points à partir du dans le coin supérieur gauche de la page. |
Renvois
Line : ligne insérée.
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
insertPageElement(pageElement)
Insère une copie de la propriété PageElement fournie sur la page.
La position de l'élément inséré sur cette page est déterminée par la balise sur sa page respective.
Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, Les propriétés qui héritent des pages maîtres ou des pages de mise en page héritent également de l'élément inséré.
Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, Les propriétés qui héritent des pages maîtres ou des pages de mise en page sont copiées dans l'élément à partir de la source. présentation.
// Copy a page element between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var pageElement = otherPresentationSlide.getPageElements()[0];
// Also available for Layout, Master, and Page.
currentPresentationSlide.insertPageElement(pageElement);
Paramètres
| Nom | Type | Description |
|---|---|---|
pageElement | PageElement | Élément de page à copier et à insérer. |
Renvois
PageElement : élément de page inséré.
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
insertShape(shape)
Insère une copie de la propriété Shape fournie sur la page.
La position de l'élément inséré sur cette page est déterminée par la balise sur sa page respective.
Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, Les propriétés qui héritent des pages maîtres ou des pages de mise en page héritent également de l'élément inséré.
Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, Les propriétés qui héritent des pages maîtres ou des pages de mise en page sont copiées dans l'élément à partir de la source. présentation.
// Copy a shape between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var shape = otherPresentationSlide.getShapes[0];
currentPresentationSlide.insertShape(shape); // Also available for Layout, Master, and Page.
Paramètres
| Nom | Type | Description |
|---|---|---|
shape | Shape | Forme à copier et à insérer. |
Renvois
Shape : forme insérée.
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
insertShape(shapeType)
Insère une forme sur la page.
La forme est insérée avec une taille par défaut dans l'angle supérieur gauche de la page.
// Insert a shape in the first slide of the presentation. var slide = SlidesApp.getActivePresentation().getSlides()[0]; // Also available for Layout, Master, and Page. slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
Paramètres
| Nom | Type | Description |
|---|---|---|
shapeType | ShapeType | Type de forme à insérer. |
Renvois
Shape : forme insérée.
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
insertShape(shapeType, left, top, width, height)
Insère une forme sur la page.
Paramètres
| Nom | Type | Description |
|---|---|---|
shapeType | ShapeType | Type de forme à insérer. |
left | Number | Position horizontale de la forme, mesurée à partir de l'angle supérieur gauche du . |
top | Number | Position verticale de la forme, mesurée à partir de l'angle supérieur gauche de la page. |
width | Number | Largeur de la forme. |
height | Number | Hauteur de la forme. |
Renvois
Shape : forme insérée.
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
insertSheetsChart(sourceChart)
Insère un graphique Google Sheets sur la page.
Le graphique est inséré avec une taille par défaut dans l'angle supérieur gauche de la page.
Le graphique inséré est lié au graphique Google Sheets source, ce qui lui permet d'être mis à 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];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChart(chart);
Paramètres
| Nom | Type | Description |
|---|---|---|
sourceChart | EmbeddedChart | Graphique d'une feuille de calcul à insérer dans la page. |
Renvois
SheetsChart : graphique inséré dans 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
insertSheetsChart(sourceChart, left, top, width, height)
Insère sur la page un graphique Google Sheets avec la position et la taille fournies.
Afin de conserver le format, le graphique est mis à l'échelle et centré par rapport à à la taille indiquée.
Le graphique inséré est lié au graphique Google Sheets source, ce qui lui permet d'être mis à 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];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var position = {left: 0, top: 0};
var size = {width: 200, height: 200};
// Also available for Layout, Master, and Page.
slide.insertSheetsChart(
chart,
position.left,
position.top,
size.width,
size.height);
Paramètres
| Nom | Type | Description |
|---|---|---|
sourceChart | EmbeddedChart | Graphique d'une feuille de calcul à insérer dans la page. |
left | Number | Position horizontale du graphique en points, mesurée à partir de l'angle supérieur gauche de la page. |
top | Number | Position verticale du graphique en points, mesurée à partir de l'angle supérieur gauche du graphique la page. |
width | Number | Largeur du graphique en points. |
height | Number | Hauteur du graphique en points. |
Renvois
SheetsChart : graphique inséré dans 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
insertSheetsChart(sheetsChart)
Insère une copie de la propriété SheetsChart fournie sur la page.
La position de l'élément inséré sur cette page est déterminée par la balise sur sa page respective.
Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, Les propriétés qui héritent des pages maîtres ou des pages de mise en page héritent également de l'élément inséré.
Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, Les propriétés qui héritent des pages maîtres ou des pages de mise en page sont copiées dans l'élément à partir de la source. présentation.
// Copy a sheets chart between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var sheetsChart = otherPresentationSlide.getSheetsCharts[0];
// Also available for Layout, Master, and Page.
currentPresentationSlide.insertSheetsChart(sheetsChart);
Paramètres
| Nom | Type | Description |
|---|---|---|
sheetsChart | SheetsChart | Graphique Sheets à copier et insérer. |
Renvois
SheetsChart : graphique des feuilles inséré.
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
insertSheetsChartAsImage(sourceChart)
Insère un graphique Google Sheets sur la page en tant que Image.
L'image du graphique est insérée avec une taille par défaut dans l'angle supérieur gauche de la page.
L'image insérée du graphique n'est pas associée au graphique Google Sheets source.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChartAsImage(chart); // Also available for Layout, Master, and Page.
Paramètres
| Nom | Type | Description |
|---|---|---|
sourceChart | EmbeddedChart | Graphique d'une feuille de calcul à insérer dans la page. |
Renvois
Image : image insérée du graphique dans 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
insertSheetsChartAsImage(sourceChart, left, top, width, height)
Insère un graphique Google Sheets sous forme de Image sur la page, avec la position indiquée et
la taille de l'image.
Afin de conserver le format de l'image du graphique, l'image est mise à l'échelle et centrée avec par rapport à la taille fournie.
L'image insérée du graphique n'est pas liée au graphique Google Sheets source.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var position = {left: 0, top: 0};
var size = {width: 200, height: 200};
// Also available for Layout, Master, and Page.
slide.insertSheetsChartAsImage(
chart,
position.left,
position.right,
size.width,
size.height);
Paramètres
| Nom | Type | Description |
|---|---|---|
sourceChart | EmbeddedChart | Graphique d'une feuille de calcul à insérer dans la page. |
left | Number | Position horizontale du graphique en points, mesurée à partir de l'angle supérieur gauche de la page. |
top | Number | Position verticale du graphique en points, mesurée à partir de l'angle supérieur gauche du graphique la page. |
width | Number | Largeur du graphique en points. |
height | Number | Hauteur du graphique en points. |
Renvois
Image : image insérée du graphique dans 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
insertTable(numRows, numColumns)
Insère un tableau sur la page.
Le tableau est centré sur la page avec sa taille par défaut et ses lignes et ses colonnes réparties uniformément.
Paramètres
| Nom | Type | Description |
|---|---|---|
numRows | Integer | Nombre de lignes dans la table. |
numColumns | Integer | Nombre de colonnes du tableau. |
Renvois
Table : table insérée.
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
insertTable(numRows, numColumns, left, top, width, height)
Insère sur la page un tableau avec la position et la taille fournies.
Les lignes et les colonnes sont réparties uniformément dans la table créée.
Paramètres
| Nom | Type | Description |
|---|---|---|
numRows | Integer | Nombre de lignes dans la table. |
numColumns | Integer | Nombre de colonnes du tableau. |
left | Number | Position horizontale du tableau, mesurée à partir de l'angle supérieur gauche du . |
top | Number | Position verticale du tableau, mesurée à partir de l'angle supérieur gauche de la page. |
width | Number | Largeur du tableau. |
height | Number | Hauteur minimale du tableau. La hauteur réelle du tableau affiché dépend sur des facteurs tels que la taille de la police du texte. |
Renvois
Table : table insérée.
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
insertTable(table)
Insère une copie de la propriété Table fournie sur la page.
La position de l'élément inséré sur cette page est déterminée par la balise sur sa page respective.
Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, Les propriétés qui héritent des pages maîtres ou des pages de mise en page héritent également de l'élément inséré.
Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, Les propriétés qui héritent des pages maîtres ou des pages de mise en page sont copiées dans l'élément à partir de la source. présentation.
// Copy a table between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var table = otherPresentationSlide.getTables[0];
currentPresentationSlide.insertTable(table); // Also available for Layout, Master, and Page.
Paramètres
| Nom | Type | Description |
|---|---|---|
table | Table | Tableau à copier et à insérer. |
Renvois
Table : table insérée.
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
insertTextBox(text)
Insère une zone de texte Shape contenant la chaîne fournie sur la page.
La zone de texte est insérée avec une taille par défaut dans l'angle supérieur gauche de la page.
// Insert text box with "Hello" on the first slide of presentation.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox('Hello'); // Also available for Layout, Master, and Page.
Paramètres
| Nom | Type | Description |
|---|---|---|
text | String | Chaîne que doit contenir la zone de texte. |
Renvois
Shape : forme de la zone de texte insérée.
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
insertTextBox(text, left, top, width, height)
Insère une zone de texte Shape contenant la chaîne fournie sur la page.
// Insert text box with "Hello" on the first slide of presentation. This text box is a square
// with a length of 10 points on each side.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox('Hello', 0, 0, 10, 10); // Also available for Layout, Master, and Page.
Paramètres
| Nom | Type | Description |
|---|---|---|
text | String | Chaîne que doit contenir la zone de texte. |
left | Number | Position horizontale de la forme de la zone de texte, mesurée à partir de l'angle supérieur gauche de la page. |
top | Number | Position verticale de la forme de la zone de texte, mesurée à partir de l'angle supérieur gauche de la page. |
width | Number | Largeur de la forme de la zone de texte. |
height | Number | Hauteur de la forme de la zone de texte. |
Renvois
Shape : forme de la zone de texte insérée.
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
insertVideo(videoUrl)
Insère une vidéo dans l'angle supérieur gauche de la page, avec une taille par défaut.
Seules les vidéos YouTube sont actuellement prises en charge.
Paramètres
| Nom | Type | Description |
|---|---|---|
videoUrl | String | URL de la vidéo à insérer. |
Renvois
Video : vidéo insérée.
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
insertVideo(videoUrl, left, top, width, height)
Insère une vidéo sur la page avec la position et la taille fournies.
Seules les vidéos YouTube sont actuellement prises en charge.
Paramètres
| Nom | Type | Description |
|---|---|---|
videoUrl | String | URL de la vidéo à insérer. |
left | Number | Position horizontale de la vidéo en points, mesurée à partir de l'angle supérieur gauche de la page. |
top | Number | Position verticale de la vidéo, exprimée en points, mesurée à partir de l'angle supérieur gauche la page. |
width | Number | Largeur de la vidéo en points. |
height | Number | Hauteur de la vidéo en points. |
Renvois
Video : vidéo insérée.
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
insertVideo(video)
Insère une copie de la propriété Video fournie sur la page.
La position de l'élément inséré sur cette page est déterminée par la balise sur sa page respective.
Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, Les propriétés qui héritent des pages maîtres ou des pages de mise en page héritent également de l'élément inséré.
Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, Les propriétés qui héritent des pages maîtres ou des pages de mise en page sont copiées dans l'élément à partir de la source. présentation.
// Copy a video between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var video = otherPresentationSlide.getVideos[0];
currentPresentationSlide.insertVideo(video); // Also available for Layout, Master, and Page.
Paramètres
| Nom | Type | Description |
|---|---|---|
video | Video | Vidéo à copier et à insérer. |
Renvois
Video : vidéo insérée.
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
insertWordArt(wordArt)
Insère une copie de la propriété WordArt fournie sur la page.
La position de l'élément inséré sur cette page est déterminée par la balise sur sa page respective.
Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, Les propriétés qui héritent des pages maîtres ou des pages de mise en page héritent également de l'élément inséré.
Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, Les propriétés qui héritent des pages maîtres ou des pages de mise en page sont copiées dans l'élément à partir de la source. présentation.
// Copy a word art between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var wordArt = otherPresentationSlide.getWordArts[0];
// Also available for Layout, Master, and Page.
currentPresentationSlide.insertWordArt(wordArt);
Paramètres
| Nom | Type | Description |
|---|---|---|
wordArt | WordArt | Groupe à copier et à insérer. |
Renvois
WordArt : texte Word Art inséré.
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 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
replaceAllText(findText, replaceText)
Remplace toutes les occurrences de texte correspondant au texte à rechercher par le texte de remplacement. La recherche est un cas insensible.
Paramètres
| Nom | Type | Description |
|---|---|---|
findText | String | Texte à rechercher. |
replaceText | String | Texte de remplacement du texte correspondant. |
Renvois
Integer : le nombre d'occurrences a changé.
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
replaceAllText(findText, replaceText, matchCase)
Remplace toutes les occurrences de texte correspondant au texte à rechercher par le texte de remplacement.
Paramètres
| Nom | Type | Description |
|---|---|---|
findText | String | Texte à rechercher. |
replaceText | String | Texte de remplacement du texte correspondant. |
matchCase | Boolean | Si la valeur est true, la recherche est sensible à la casse. Si la valeur est false, la recherche est
non sensible à la casse. |
Renvois
Integer : le nombre d'occurrences a changé.
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
selectAsCurrentPage()
Sélectionne le Page dans la présentation active en tant que current page selection et supprime toute sélection précédente.
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.
// Select the first slide as the current page selection and replace any previous selection. var slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.selectAsCurrentPage(); // Also available for Layout, Master, and 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