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

Class Layout

Mise en page dans une présentation.

Chaque mise en page sert de modèle aux diapositives qui en héritent, et détermine la disposition et le style du contenu de ces diapositives.

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 le `ColorScheme` associé à 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'ID unique de la page.
`getPageElementById(id)`	`PageElement`	Renvoie la `PageElement` de la page dont l'ID est indiqué, ou `null` si aucune n'existe.
`getPageElements()`	`PageElement[]`	Renvoie la liste des objets `PageElement` affichés sur la page.
`getPageType()`	`PageType`	Récupère le type de la page.
`getPlaceholder(placeholderType)`	`PageElement`	Renvoie l'objet `PageElement` d'espace réservé pour un `PlaceholderType` ou `null` spécifié si aucun espace réservé correspondant n'est présent.
`getPlaceholder(placeholderType, placeholderIndex)`	`PageElement`	Renvoie l'objet `PageElement` d'espace réservé pour un `PlaceholderType` spécifié et un indice d'espace réservé, ou `null` si l'espace réservé n'est pas présent.
`getPlaceholders()`	`PageElement[]`	Renvoie la liste des objets `PageElement` d'espace réservé de 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 du `Group` fourni sur la page.
`insertImage(blobSource)`	`Image`	Insère une image en haut à gauche de la page avec une taille par défaut à partir du blob d'image spécifié.
`insertImage(blobSource, left, top, width, height)`	`Image`	Insère une image sur la page avec la position et la taille fournies à partir du blob d'image spécifié.
`insertImage(image)`	`Image`	Insère une copie du `Image` fourni sur la page.
`insertImage(imageUrl)`	`Image`	Insère une image en haut à gauche de la page, à partir de l'URL fournie, avec une taille par défaut.
`insertImage(imageUrl, left, top, width, height)`	`Image`	Insère une image sur la page à la position et à la taille indiquées à partir de l'URL fournie.
`insertLine(line)`	`Line`	Insère une copie du `Line` fourni 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 du `PageElement` fourni sur la page.
`insertShape(shape)`	`Shape`	Insère une copie du `Shape` fourni 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 un graphique Google Sheets sur la page avec la position et la taille fournies.
`insertSheetsChart(sheetsChart)`	`SheetsChart`	Insère une copie du `SheetsChart` fourni sur la page.
`insertSheetsChartAsImage(sourceChart)`	`Image`	Insère un graphique Google Sheets en tant que `Image` sur la page.
`insertSheetsChartAsImage(sourceChart, left, top, width, height)`	`Image`	Insère un graphique Google Sheets en tant que `Image` sur la page avec la position et la taille fournies.
`insertTable(numRows, numColumns)`	`Table`	Insère un tableau sur la page.
`insertTable(numRows, numColumns, left, top, width, height)`	`Table`	Insère un tableau sur la page avec la position et la taille fournies.
`insertTable(table)`	`Table`	Insère une copie du `Table` fourni 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 du `Video` fourni sur la page.
`insertWordArt(wordArt)`	`WordArt`	Insère une copie du `WordArt` fourni sur la page.
`remove()`	`void`	Supprime la page.
`replaceAllText(findText, replaceText)`	`Integer`	Remplace toutes les occurrences du texte correspondant au texte à rechercher par le texte de remplacement.
`replaceAllText(findText, replaceText, matchCase)`	`Integer`	Remplace toutes les occurrences du texte correspondant au texte à rechercher par le texte de remplacement.
`selectAsCurrentPage()`	`void`	Sélectionne le `Page` de la présentation active comme `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 avec 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 le ColorScheme associé à la page.

Renvois

ColorScheme : jeu de couleurs de la page.

Autorisation

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

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

`getGroups()`

Affiche la liste des objets Group sur la page.

Renvois

Group[]

Autorisation

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

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

`getImages()`

Affiche la liste des objets Image sur la page.

Renvois

Image[]

Autorisation

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

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

`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 avec 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

Line[]

Autorisation

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

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

`getMaster()`

Récupère le maître sur lequel la mise en page est basée.

Renvois

Master

Autorisation

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

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

`getObjectId()`

Récupère l'ID unique de la page. Les ID d'objet utilisés par les pages et les éléments de page partagent le même espace de noms.

Renvois

String

Autorisation

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

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

`getPageElementById(id)`

Renvoie la PageElement de la page dont l'ID est indiqué, ou null si aucune n'existe.

Paramètres

Nom	Type	Description
`id`	`String`	ID de l'élément de page récupéré.

Renvois

PageElement : élément de page dont l'ID est indiqué.

Autorisation

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

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

`getPageElements()`

Renvoie la liste des objets PageElement affichés sur la page.

Renvois

PageElement[]

Autorisation

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

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

`getPageType()`

Récupère le type de la page.

Renvois

PageType : type de page.

Autorisation

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

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

`getPlaceholder(placeholderType)`

Renvoie l'objet PageElement d'espace réservé pour un PlaceholderType ou null spécifié si aucun espace réservé correspondant n'est présent.

Si plusieurs espaces réservés du même type existent, celui renvoyé est celui dont l'index est le plus faible. Si plusieurs espaces réservés correspondants ont le même indice, la fonction renvoie le premier espace réservé de la collection d'éléments de la page.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const placeholder = slide.getPlaceholder(
    SlidesApp.PlaceholderType.CENTERED_TITLE,
);

Paramètres

Nom	Type	Description
`placeholderType`	`PlaceholderType`

Renvois

PageElement

Autorisation

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

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

`getPlaceholder(placeholderType, placeholderIndex)`

Renvoie l'objet PageElement d'espace réservé pour un PlaceholderType spécifié et un indice d'espace réservé, ou null si l'espace réservé n'est pas présent.

Si plusieurs espaces réservés ont le même type et le même index, la fonction renvoie le premier espace réservé de la collection d'éléments de la page.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const placeholder = slide.getPlaceholder(
    SlidesApp.PlaceholderType.CENTERED_TITLE,
    0,
);

Paramètres

Nom	Type	Description
`placeholderType`	`PlaceholderType`
`placeholderIndex`	`Integer`

Renvois

PageElement

Autorisation

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

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

`getPlaceholders()`

Renvoie la liste des objets PageElement d'espace réservé de la page.

const master = SlidesApp.getActivePresentation().getMasters()[0];
Logger.log(
    `Number of placeholders in the master: ${master.getPlaceholders().length}`,
);

Renvois

PageElement[]

Autorisation

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

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

`getShapes()`

Affiche la liste des objets Shape sur la page.

Renvois

Shape[]

Autorisation

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

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

`getSheetsCharts()`

Affiche la liste des objets SheetsChart sur la page.

Renvois

SheetsChart[]

Autorisation

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

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

`getTables()`

Affiche la liste des objets Table sur la page.

Renvois

Table[]

Autorisation

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

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

`getVideos()`

Affiche la liste des objets Video sur la page.

Renvois

Video[]

Autorisation

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

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

`getWordArts()`

Affiche la liste des objets WordArt sur la page.

Renvois

WordArt[]

Autorisation

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

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

`group(pageElements)`

Regroupe tous les éléments de page spécifiés.

La page doit comporter au moins deux éléments qui ne font pas déjà partie d'un 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 avec 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 du Group fourni sur la page.

La position de l'élément inséré sur cette page est déterminée à partir de la position de l'élément source 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 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 de mise en page sont copiées sur l'élément à partir de la présentation source.

// Copy a group between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const 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 avec 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 une image en haut à gauche de la page avec une taille par défaut à partir du blob d'image spécifié.

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

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
const image = DriveApp.getFileById('123abc');
slide.insertImage(image);

Paramètres

Nom	Type	Description
`blobSource`	`BlobSource`	Données d'image.

Renvois

Image : image insérée.

Autorisation

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

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

`insertImage(blobSource, left, top, width, height)`

Insère une image sur la page avec la position et la taille fournies à partir du blob d'image spécifié.

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

Pour conserver le format de l'image, celle-ci est redimensionnée et centrée par rapport à la taille fournie.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
const image = DriveApp.getFileById('123abc');
const position = {
  left: 0,
  top: 0
};
const 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 d'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 avec 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 du Image fourni 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 sa 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 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 de mise en page sont copiées sur l'image à partir de la présentation source. Si l'image d'espace réservé copiée est vide, rien n'est inséré dans la présentation de destination.

// Copy an image between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const 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 avec 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 une image en haut à gauche de la page, à partir de l'URL fournie, avec une taille par défaut.

Lorsque vous insérez l'image, elle est récupérée à partir de l'URL une seule fois, et une copie est stockée pour être affichée dans la présentation. Les images doivent être inférieures à 50 Mo, ne pas dépasser 25 mégapixels et être au format PNG, JPEG ou GIF.

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

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 avec 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 à la position et à la taille indiquées à partir de l'URL fournie.

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

Pour conserver le format de l'image, celle-ci est redimensionnée et centrée par rapport à la taille fournie.

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 avec 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 du Line fourni sur la page.

La position de l'élément inséré sur cette page est déterminée à partir de la position de l'élément source sur sa page respective.

// Copy a line between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const 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 avec 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.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
const 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`	Site de connexion où le début de la ligne doit être connecté.
`endConnectionSite`	`ConnectionSite`	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 avec 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.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const startPoint = {
  left: 10,
  top: 10
};
const 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 à partir de l'angle supérieur gauche de la page.
`startTop`	`Number`	Position verticale du point de départ de la ligne, mesurée en points à partir de l'angle supérieur gauche de la page.
`endLeft`	`Number`	Position horizontale du point final de la ligne, mesurée en points à partir de l'angle supérieur gauche de la page.
`endTop`	`Number`	Position verticale du point d'arrivée de la ligne, mesurée en points à partir de l'angle supérieur gauche de la page.

Renvois

Line : ligne insérée.

Autorisation

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

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

`insertPageElement(pageElement)`

Insère une copie du PageElement fourni sur la page.

La position de l'élément inséré sur cette page est déterminée à partir de la position de l'élément source sur sa page respective.

// Copy a page element between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const 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 avec 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 du Shape fourni sur la page.

La position de l'élément inséré sur cette page est déterminée à partir de la position de l'élément source sur sa page respective.

// Copy a shape between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const 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 avec 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 en haut à gauche de la page.

// Insert a shape in the first slide of the presentation.
const 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 avec 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 de la page.
`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 avec 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é dans la taille par défaut en haut à gauche de la page.

Le graphique inséré est associé au graphique Google Sheets source, ce qui permet de le mettre à jour. Les autres collaborateurs voient le lien vers la feuille de calcul source.

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const 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é sur la page.

Autorisation

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

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

`insertSheetsChart(sourceChart, left, top, width, height)`

Insère un graphique Google Sheets sur la page avec la position et la taille fournies.

Pour conserver le format du graphique, celui-ci est mis à l'échelle et centré par rapport à la taille fournie.

Le graphique inséré est associé au graphique Google Sheets source, ce qui permet de le mettre à jour. Les autres collaborateurs voient le lien vers la feuille de calcul source.

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const position = {
  left: 0,
  top: 0
};
const 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 de la page.
`width`	`Number`	Largeur du graphique en points.
`height`	`Number`	Hauteur du graphique en points.

Renvois

SheetsChart : graphique inséré sur la page.

Autorisation

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

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

`insertSheetsChart(sheetsChart)`

Insère une copie du SheetsChart fourni sur la page.

La position de l'élément inséré sur cette page est déterminée à partir de la position de l'élément source sur sa page respective.

// Copy a sheets chart between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const 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 Sheets inséré.

Autorisation

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

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

`insertSheetsChartAsImage(sourceChart)`

Insère un graphique Google Sheets en tant que Image sur la page.

L'image du graphique est insérée dans une taille par défaut en haut à gauche de la page.

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

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const 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 sur la page.

Autorisation

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

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

`insertSheetsChartAsImage(sourceChart, left, top, width, height)`

Insère un graphique Google Sheets en tant que Image sur la page avec la position et la taille fournies.

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

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

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const position = {
  left: 0,
  top: 0
};
const 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 de la page.
`width`	`Number`	Largeur du graphique en points.
`height`	`Number`	Hauteur du graphique en points.

Renvois

Image : image insérée du graphique sur la page.

Autorisation

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

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

`insertTable(numRows, numColumns)`

Insère un tableau sur la page.

Le tableau est centré sur la page, avec une taille par défaut et des lignes et colonnes réparties de manière uniforme.

Paramètres

Nom	Type	Description
`numRows`	`Integer`	Nombre de lignes dans la table.
`numColumns`	`Integer`	Nombre de colonnes dans la table.

Renvois

Table : tableau inséré.

Autorisation

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

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

`insertTable(numRows, numColumns, left, top, width, height)`

Insère un tableau sur la page avec la position et la taille fournies.

Les lignes et les colonnes sont réparties de manière uniforme dans le tableau créé.

Paramètres

Nom	Type	Description
`numRows`	`Integer`	Nombre de lignes dans la table.
`numColumns`	`Integer`	Nombre de colonnes dans la table.
`left`	`Number`	Position horizontale du tableau, mesurée à partir de l'angle supérieur gauche de la page.
`top`	`Number`	Position verticale du tableau, mesurée à partir de l'angle supérieur gauche de la page.
`width`	`Number`	Largeur de la table.
`height`	`Number`	Hauteur minimale de la table. La hauteur réelle du tableau affiché dépend de facteurs tels que la taille de la police de texte.

Renvois

Table : tableau inséré.

Autorisation

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

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

`insertTable(table)`

Insère une copie du Table fourni sur la page.

La position de l'élément inséré sur cette page est déterminée à partir de la position de l'élément source sur sa page respective.

// Copy a table between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const 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 : tableau inséré.

Autorisation

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

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

`insertTextBox(text)`

Insère une zone de texte Shape contenant la chaîne fournie sur la page.

La forme de la zone de texte est insérée avec une taille par défaut en haut à gauche de la page.

// Insert text box with "Hello" on the first slide of presentation.
const 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 la forme de la zone de texte doit contenir.

Renvois

Shape : forme de la zone de texte insérée.

Autorisation

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

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

`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.
const 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 la forme de la zone de texte doit contenir.
`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 avec 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 compatibles.

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 avec 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 compatibles.

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 en points, mesurée à partir de l'angle supérieur gauche de 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 avec 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 du Video fourni sur la page.

La position de l'élément inséré sur cette page est déterminée à partir de la position de l'élément source sur sa page respective.

// Copy a video between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const 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 avec 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 du WordArt fourni sur la page.

La position de l'élément inséré sur cette page est déterminée à partir de la position de l'élément source sur sa page respective.

// Copy a word art between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const 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 avec 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 avec 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 du texte correspondant au texte à rechercher par le texte de remplacement. La recherche n'est pas sensible à la casse.

Paramètres

Nom	Type	Description
`findText`	`String`	Texte à rechercher.
`replaceText`	`String`	Texte à remplacer par le texte correspondant.

Renvois

Integer : nombre d'occurrences modifiées

Autorisation

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

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

`replaceAllText(findText, replaceText, matchCase)`

Remplace toutes les occurrences du texte correspondant au texte à rechercher par le texte de remplacement.

Paramètres

Nom	Type	Description
`findText`	`String`	Texte à rechercher.
`replaceText`	`String`	Texte à remplacer par le texte correspondant.
`matchCase`	`Boolean`	Si la valeur est `true`, la recherche est sensible à la casse. Si la valeur est `false`, la recherche n'est pas sensible à la casse.

Renvois

Integer : nombre d'occurrences modifiées

Autorisation

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

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

`selectAsCurrentPage()`

Sélectionne le Page de la présentation active comme 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 uniquement si le script est lié à la présentation.

// Select the first slide as the current page selection and replace any previous
// selection.
const 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 avec un ou plusieurs des champs d'application suivants:

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