Class SheetsChart

SheetsChart

PageElement représentant un graphique associé intégré à partir de Google Sheets.

Méthodes

MéthodeType renvoyéBrève description
alignOnPage(alignmentPosition)SheetsChartAligne l'élément sur la position d'alignement spécifiée sur la page.
asImage()ImageRenvoie le graphique sous forme d'image ou null s'il ne s'agit pas d'une image intégrée.
bringForward()SheetsChartFait avancer l'élément de page d'un élément.
bringToFront()SheetsChartPlace l'élément de page au premier plan.
duplicate()PageElementDuplique l'élément de page.
getChartId()IntegerRécupère l'ID du graphique spécifique dans la feuille de calcul Google Sheets intégrée.
getConnectionSites()ConnectionSite[]Renvoie la liste des ConnectionSite de l'élément de page, ou une liste vide si l'élément de page ne comporte aucun site de connexion.
getDescription()StringRenvoie la description du texte alternatif de l'élément de page.
getEmbedType()SheetsChartEmbedTypeRenvoie le type d'intégration du graphique Sheets.
getHeight()NumberRécupère la hauteur de l'élément en points, qui correspond à la hauteur de la zone de délimitation de l'élément lorsqu'il n'est pas en rotation.
getInherentHeight()NumberRenvoie la hauteur inhérente de l'élément en points.
getInherentWidth()NumberRenvoie la largeur inhérente de l'élément en points.
getLeft()NumberRenvoie la position horizontale de l'élément en points, mesurée à partir de l'angle supérieur gauche de la page lorsque l'élément n'est pas pivoté.
getLink()LinkRenvoie Link ou null s'il n'y a pas de lien.
getObjectId()StringRenvoie l'ID unique de cet objet.
getPageElementType()PageElementTypeRenvoie le type de l'élément de page, représenté sous la forme d'une énumération PageElementType.
getParentGroup()GroupRenvoie le groupe auquel appartient cet élément de page, ou null si l'élément ne fait pas partie d'un groupe.
getParentPage()PageRenvoie la page sur laquelle se trouve cet élément de page.
getRotation()NumberRenvoie l'angle de rotation de l'élément dans le sens des aiguilles d'une montre autour de son centre, en degrés, où zéro degré signifie aucune rotation.
getSpreadsheetId()StringRécupère l'ID de la feuille de calcul Google Sheets contenant le graphique source.
getTitle()StringRenvoie le titre du texte alternatif de l'élément de page.
getTop()NumberRécupère la position verticale de l'élément en points, mesurée à partir du coin supérieur gauche de la page lorsque l'élément n'est pas en rotation.
getTransform()AffineTransformRenvoie la transformation de l'élément de page.
getWidth()NumberRenvoie la largeur de l'élément en points, qui correspond à la largeur de la zone de délimitation de l'élément lorsqu'il n'est pas en rotation.
preconcatenateTransform(transform)SheetsChartPréconcatène la transformation fournie à la transformation existante de l'élément de page.
refresh()voidActualise le graphique en le remplaçant par la dernière version de Google Sheets.
remove()voidSupprime l'élément de la page.
removeLink()voidSupprime un Link.
scaleHeight(ratio)SheetsChartÉtale la hauteur de l'élément selon le ratio spécifié.
scaleWidth(ratio)SheetsChartÉtale la largeur de l'élément selon le format spécifié.
select()voidSélectionne uniquement le PageElement dans la présentation active et supprime toute sélection précédente.
select(replace)voidSélectionne le PageElement dans la présentation active.
sendBackward()SheetsChartFait reculer l'élément de page d'un élément.
sendToBack()SheetsChartMet l'élément de page à l'arrière de la page.
setDescription(description)SheetsChartDéfinit la description du texte alternatif de l'élément de page.
setHeight(height)SheetsChartDéfinit la hauteur de l'élément en points, qui correspond à la hauteur de la zone de délimitation de l'élément lorsqu'il n'est pas en rotation.
setLeft(left)SheetsChartDéfinit la position horizontale de l'élément en points, mesurée à partir du coin supérieur gauche de la page lorsque l'élément n'est pas pivoté.
setLinkSlide(slideIndex)LinkDéfinit un Link sur l'Slide donné à l'aide de l'indice de la diapositive basé sur zéro.
setLinkSlide(slide)LinkDéfinit un Link sur l'Slide donné. Le lien est défini par l'ID de diapositive donné.
setLinkSlide(slidePosition)LinkDéfinit un Link sur l'Slide donné à l'aide de la position relative de la diapositive.
setLinkUrl(url)LinkDéfinit un Link sur la chaîne d'URL non vide donnée.
setRotation(angle)SheetsChartDéfinit l'angle de rotation de l'élément dans le sens des aiguilles d'une montre autour de son centre, en degrés.
setTitle(title)SheetsChartDéfinit le titre du texte alternatif de l'élément de page.
setTop(top)SheetsChartDéfinit la position verticale de l'élément en points, mesurée à partir du coin supérieur gauche de la page lorsque l'élément n'est pas en rotation.
setTransform(transform)SheetsChartDéfinit la transformation de l'élément de page avec la transformation fournie.
setWidth(width)SheetsChartDéfinit la largeur de l'élément en points, qui correspond à la largeur de la zone de délimitation de l'élément lorsque celui-ci n'est pas en rotation.

Documentation détaillée

alignOnPage(alignmentPosition)

Aligne l'élément sur la position d'alignement spécifiée sur la page.

Paramètres

NomTypeDescription
alignmentPositionAlignmentPositionPosition à laquelle aligner cet élément de page.

Renvois

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


asImage()

Renvoie le graphique sous forme d'image ou null s'il ne s'agit pas d'une image intégrée.

Renvois

Image : ce graphique en tant qu'image, ou null si le graphique n'est pas une image intégré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

bringForward()

Fait avancer l'élément de page d'un élément.

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

Renvois

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

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

bringToFront()

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

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

Renvois

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

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

duplicate()

Duplique l'élément de page.

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

Renvois

PageElement : nouveau double de cet élément 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

getChartId()

Récupère l'ID du graphique spécifique dans la feuille de calcul Google Sheets intégrée.

Renvois

Integer : ID du graphique intégré.

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

getConnectionSites()

Renvoie la liste des ConnectionSite de l'élément de page, ou une liste vide si l'élément de page ne comporte aucun site de connexion.

Renvois

ConnectionSite[] : liste des sites de connexion, qui peut être vide si cet élément ne comporte aucun site de connexion.

Autorisation

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

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

getDescription()

Renvoie la description du texte alternatif de l'élément de page. La description est combinée au titre pour afficher et lire le texte alternatif.

Renvois

String : description du texte alternatif de l'élément 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

getEmbedType()

Renvoie le type d'intégration du graphique Sheets.

Renvois

SheetsChartEmbedType : type d'intégration de ce graphique.

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

getHeight()

Récupère la hauteur de l'élément en points, qui correspond à la hauteur de la zone de délimitation de l'élément lorsqu'il n'est pas en rotation.

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

Renvois

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

Autorisation

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

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

getInherentHeight()

Renvoie la hauteur inhérente de l'élément en points.

La transformation de l'élément de page est relative à sa taille intrinsèque. Utilisez la taille inhérente en conjonction avec la transformation de l'élément pour déterminer son apparence visuelle finale.

Renvois

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

Autorisation

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

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

getInherentWidth()

Renvoie la largeur inhérente de l'élément en points.

La transformation de l'élément de page est relative à sa taille intrinsèque. Utilisez la taille inhérente en conjonction avec la transformation de l'élément pour déterminer son apparence visuelle finale.

Renvois

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

Autorisation

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

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

getLeft()

Renvoie la position horizontale de l'élément en points, mesurée à partir de l'angle supérieur gauche de la page lorsque l'élément n'est pas pivoté.

Renvois

Number : position horizontale de cet élément en points, à partir du coin supérieur gauche 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

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

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null) {
  Logger.log(`Shape has a link of type: ${link.getLinkType()}`);
}

Renvois

Link : Link ou null si aucun lien n'est associé.

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()

Renvoie l'ID unique de cet objet. Les ID d'objet utilisés par les pages et les éléments de page partagent le même espace de noms.

Renvois

String : ID unique de cet objet.

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

getPageElementType()

Renvoie le type de l'élément de page, représenté sous la forme d'une énumération PageElementType.

Renvois

PageElementType : type de l'élément 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

getParentGroup()

Renvoie le groupe auquel appartient cet élément de page, ou null si l'élément ne fait pas partie d'un groupe.

Renvois

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

Autorisation

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

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

getParentPage()

Renvoie la page sur laquelle se trouve cet élément de page.

Renvois

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

Autorisation

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

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

getRotation()

Renvoie l'angle de rotation de l'élément dans le sens des aiguilles d'une montre autour de son centre, en degrés, où zéro degré signifie aucune rotation.

Renvois

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

Autorisation

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

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

getSpreadsheetId()

Récupère l'ID de la feuille de calcul Google Sheets contenant le graphique source.

Renvois

String : ID de la feuille de calcul contenant le graphique source.

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

getTitle()

Renvoie le titre du texte alternatif de l'élément de page. Le titre est combiné à la description pour afficher et lire le texte alternatif.

Renvois

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

Autorisation

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

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

getTop()

Récupère la position verticale de l'élément en points, mesurée à partir du coin supérieur gauche de la page lorsque l'élément n'est pas en rotation.

Renvois

Number : position verticale de cet élément en points, à partir du coin supérieur gauche 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

getTransform()

Renvoie la transformation de l'élément de page.

L'apparence visuelle de l'élément de page est déterminée par sa transformation absolue. Pour calculer la transformation absolue, préconcaténez la transformation d'un élément de page avec les transformations de tous ses groupes parents. Si l'élément de page ne fait pas partie d'un groupe, sa transformation absolue est identique à la valeur de ce champ.

Renvois

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

Autorisation

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

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

getWidth()

Renvoie la largeur de l'élément en points, qui correspond à la largeur de la zone de délimitation de l'élément lorsqu'il n'est pas en rotation.

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

Renvois

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

Autorisation

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

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

preconcatenateTransform(transform)

Préconcatène la transformation fournie à la transformation existante de l'élément de page.

newTransform = argument * existingTransform;

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

const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
element.preconcatenateTransform(
    SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(),
);

Vous pouvez également remplacer la transformation de l'élément de page par setTransform(transform).

Paramètres

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

Renvois

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

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

refresh()

Actualise le graphique en le remplaçant par la dernière version de Google Sheets. Si le graphique est déjà à jour, aucune modification n'est apportée au graphique dans la présentation.

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/spreadsheets.readonly

remove()

Supprime l'élément de la page.

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

Si un espace réservé PageElement est supprimé sur un modèle ou une mise en page, tous les espaces réservés hérités vides sont également supprimés.

Autorisation

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

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

Supprime un Link.

const slides = SlidesApp.getActivePresentation().getSlides();
slides[1].getShapes()[0].removeLink();

scaleHeight(ratio)

Étale la hauteur de l'élément selon le ratio spécifié. La hauteur de l'élément correspond à la hauteur de sa zone de délimitation lorsque l'élément n'est pas en rotation.

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

Paramètres

NomTypeDescription
ratioNumberRapport de scaling de la hauteur de cet élément de page.

Renvois

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

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

scaleWidth(ratio)

Étale la largeur de l'élément selon le format spécifié. La largeur de l'élément correspond à la largeur de sa zone de délimitation lorsque l'élément n'est pas en rotation.

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

Paramètres

NomTypeDescription
ratioNumberRatio de scaling de la largeur de cet élément de page.

Renvois

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

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

select()

Sélectionne uniquement le PageElement dans la présentation active et supprime toute sélection précédente. Cela revient à appeler select(replace) avec true.

Un script ne peut accéder qu'à la sélection de l'utilisateur qui l'exécute, et uniquement si le script est lié à la présentation.

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

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const pageElement = slide.getPageElements()[0];
// Only select this page element and replace any previous selection.
pageElement.select();

Autorisation

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

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

select(replace)

Sélectionne le PageElement dans la présentation active.

Un script ne peut accéder qu'à la sélection de l'utilisateur qui l'exécute, et uniquement si le script est lié à la présentation.

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

Transmettez false pour sélectionner plusieurs objets PageElement. Les objets PageElement doivent se trouver dans le même Page.

Les conditions suivantes doivent être remplies lorsque vous sélectionnez un élément de page à l'aide d'un paramètre false:

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

Pour vous en assurer, l'approche recommandée consiste à sélectionner d'abord le Page parent à l'aide de Page.selectAsCurrentPage(), puis à sélectionner les éléments de la page sur cette page.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// First select the slide page, as the current page selection.
slide.selectAsCurrentPage();
// Then select all the page elements in the selected slide page.
const pageElements = slide.getPageElements();
for (let i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

Paramètres

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

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

sendBackward()

Fait reculer l'élément de page d'un élément.

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

Renvois

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

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

sendToBack()

Met l'élément de page à l'arrière de la page.

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

Renvois

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

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

setDescription(description)

Définit la description du texte alternatif de l'élément de page.

La méthode n'est pas compatible avec les éléments Group.

// Set the first page element's alt text description to "new alt text
// description".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

Paramètres

NomTypeDescription
descriptionStringChaîne à définir comme description du texte alternatif.

Renvois

SheetsChart : élément de cette 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

setHeight(height)

Définit la hauteur de l'élément en points, qui correspond à la hauteur de la zone de délimitation de l'élément lorsqu'il n'est pas en rotation.

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

Paramètres

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

Renvois

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

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

setLeft(left)

Définit la position horizontale de l'élément en points, mesurée à partir du coin supérieur gauche de la page lorsque l'élément n'est pas pivoté.

Paramètres

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

Renvois

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

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

setLinkSlide(slideIndex)

Définit un Link sur l'Slide donné à l'aide de l'indice de la diapositive basé sur zéro.

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(0);

Paramètres

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

Renvois

Link : Link défini.

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

setLinkSlide(slide)

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

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(slides[0]);

Paramètres

NomTypeDescription
slideSlideSlide à associer.

Renvois

Link : Link défini.

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

setLinkSlide(slidePosition)

Définit un Link sur l'Slide donné à l'aide de la position relative de la diapositive.

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

Paramètres

NomTypeDescription
slidePositionSlidePositionSlidePosition relatif.

Renvois

Link : Link défini.

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

setLinkUrl(url)

Définit un Link sur la chaîne d'URL non vide donnée.

// Set a link to the URL.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkUrl('https://slides.google.com');

Paramètres

NomTypeDescription
urlStringChaîne d'URL.

Renvois

Link : Link défini.

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

setRotation(angle)

Définit l'angle de rotation de l'élément dans le sens des aiguilles d'une montre autour de son centre, en degrés.

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

Paramètres

NomTypeDescription
angleNumberNouvel angle de rotation dans le sens des aiguilles d'une montre à définir, en degrés.

Renvois

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

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

setTitle(title)

Définit le titre du texte alternatif de l'élément de page.

La méthode n'est pas compatible avec les éléments Group.

// Set the first page element's alt text title to "new alt text title".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

Paramètres

NomTypeDescription
titleStringChaîne à définir comme titre du texte alternatif.

Renvois

SheetsChart : élément de cette 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

setTop(top)

Définit la position verticale de l'élément en points, mesurée à partir du coin supérieur gauche de la page lorsque l'élément n'est pas en rotation.

Paramètres

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

Renvois

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

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

setTransform(transform)

Définit la transformation de l'élément de page avec la transformation fournie.

Modifier la transformation d'un groupe modifie la transformation absolue des éléments de page de ce groupe, ce qui peut modifier leur apparence visuelle.

Modifier la transformation d'un élément de page appartenant à un groupe ne modifie que la transformation de cet élément de page. Cela n'a aucune incidence sur les transformations du groupe ni sur les autres éléments de page du groupe.

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

Paramètres

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

Renvois

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

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

setWidth(width)

Définit la largeur de l'élément en points, qui correspond à la largeur de la zone de délimitation de l'élément lorsque celui-ci n'est pas en rotation.

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

Paramètres

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

Renvois

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

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