Class Line

Line

PageElement représentant une ligne.

Méthodes

MéthodeType renvoyéBrève description
alignOnPage(alignmentPosition)LineAligne l'élément sur la position d'alignement spécifiée sur la page.
bringForward()LineFait avancer l'élément de page d'un élément.
bringToFront()LinePlace l'élément de page au premier plan.
duplicate()PageElementDuplique l'élément de la page.
getConnectionSites()ConnectionSite[]Renvoie la liste des ConnectionSite sur l'élément de page, ou une liste vide si l'élément de page ne comporte aucun site de connexion.
getDashStyle()DashStyleRécupère le DashStyle de la ligne.
getDescription()StringRenvoie la description du texte alternatif de l'élément de page.
getEnd()PointRenvoie le point d'extrémité de la ligne, mesuré à partir de l'angle supérieur gauche de la page.
getEndArrow()ArrowStyleObtient le ArrowStyle de la flèche à la fin de la ligne.
getEndConnection()ConnectionSite|nullRenvoie la connexion à la fin de la ligne ou null s'il n'y a pas de connexion.
getHeight()Number|nullObtient la hauteur de l'élément en points, qui correspond à la hauteur du cadre de sélection de l'élément lorsque celui-ci n'est pas en rotation.
getInherentHeight()Number|nullRenvoie la hauteur inhérente de l'élément en points.
getInherentWidth()Number|nullRenvoie 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 en rotation.
getLineCategory()LineCategoryRécupère le LineCategory de la ligne.
getLineFill()LineFillRécupère le LineFill de la ligne.
getLineType()LineTypeRécupère le LineType de la ligne.
getLink()Link|nullRenvoie 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'un enum PageElementType.
getParentGroup()Group|nullRenvoie le groupe auquel appartient cet élément de page, ou null si l'élément n'appartient à aucun groupe.
getParentPage()PageRenvoie la page sur laquelle se trouve cet élément de page.
getRotation()NumberRenvoie l'angle de rotation de l'élément autour de son centre dans le sens des aiguilles d'une montre, en degrés. Zéro degré signifie qu'il n'y a pas de rotation.
getStart()PointRenvoie le point de départ de la ligne, mesuré à partir de l'angle supérieur gauche de la page.
getStartArrow()ArrowStyleObtient le ArrowStyle de la flèche au début de la ligne.
getStartConnection()ConnectionSite|nullRenvoie la connexion au début de la ligne, ou null s'il n'y a pas de connexion.
getTitle()StringRenvoie le titre du texte alternatif de l'élément de page.
getTop()NumberObtient 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 pivoté.
getTransform()AffineTransformRenvoie la transformation de l'élément de page.
getWeight()NumberRenvoie l'épaisseur de la ligne en points.
getWidth()Number|nullRenvoie la largeur de l'élément en points, qui correspond à la largeur du cadre de sélection de l'élément lorsque celui-ci n'est pas pivoté.
isConnector()BooleanRenvoie true si la ligne est un connecteur, ou false dans le cas contraire.
preconcatenateTransform(transform)LinePréconcatène la transformation fournie à la transformation existante de l'élément de page.
remove()voidSupprime l'élément de la page.
removeLink()voidSupprime une Link.
reroute()LineRedirige le début et la fin de la ligne vers les deux sites de connexion les plus proches sur les éléments de page connectés.
scaleHeight(ratio)LineMet à l'échelle la hauteur de l'élément selon le ratio spécifié.
scaleWidth(ratio)LineMet à l'échelle la largeur de l'élément selon le ratio spécifié.
select()voidSélectionne uniquement le PageElement dans la présentation active et supprime toute sélection précédente.
select(replace)voidSélectionne le PageElement dans la présentation active.
sendBackward()LineEnvoie l'élément de page vers l'arrière d'un élément.
sendToBack()LineEnvoie l'élément de page à l'arrière-plan de la page.
setDashStyle(style)LineDéfinit le DashStyle de la ligne.
setDescription(description)LineDéfinit la description du texte alternatif de l'élément de page.
setEnd(left, top)LineDéfinit la position du point d'arrivée de la ligne.
setEnd(point)LineDéfinit la position du point d'arrivée de la ligne.
setEndArrow(style)LineDéfinit le ArrowStyle de la flèche à la fin de la ligne.
setEndConnection(connectionSite)LineDéfinit la connexion à la fin de la ligne.
setHeight(height)LineDéfinit la hauteur de l'élément en points, qui correspond à la hauteur du cadre de sélection de l'élément lorsque celui-ci n'est pas en rotation.
setLeft(left)LineDéfinit la position horizontale de l'élément en points, mesurée à partir de l'angle supérieur gauche de la page lorsque l'élément n'est pas pivoté.
setLineCategory(lineCategory)LineDéfinit le LineCategory de la ligne.
setLinkSlide(slideIndex)LinkDéfinit un Link sur le Slide donné à l'aide de l'index base zéro de la diapositive.
setLinkSlide(slide)LinkDéfinit un Link sur le Slide donné. Le lien est défini par l'ID de diapositive donné.
setLinkSlide(slidePosition)LinkDéfinit un Link sur le Slide donné en utilisant la position relative de la diapositive.
setLinkUrl(url)LinkDéfinit un Link sur la chaîne d'URL non vide donnée.
setRotation(angle)LineDéfinit l'angle de rotation de l'élément autour de son centre (dans le sens des aiguilles d'une montre), en degrés.
setStart(left, top)LineDéfinit la position du point de départ de la ligne.
setStart(point)LineDéfinit la position du point de départ de la ligne.
setStartArrow(style)LineDéfinit le ArrowStyle de la flèche au début de la ligne.
setStartConnection(connectionSite)LineDéfinit la connexion au début de la ligne.
setTitle(title)LineDéfinit le titre du texte alternatif de l'élément de page.
setTop(top)LineDé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 pivoté.
setTransform(transform)LineDéfinit la transformation de l'élément de page avec la transformation fournie.
setWeight(points)LineDéfinit l'épaisseur de la ligne en points.
setWidth(width)LineDéfinit la largeur de l'élément en points, qui correspond à la largeur du cadre de sélection de l'élément lorsque celui-ci n'est pas pivoté.

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

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


bringForward()

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

L'élément de page ne doit pas se trouver dans un groupe.

Renvois

Line : 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 scopes 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 se trouver dans un groupe.

Renvois

Line : 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 scopes suivants :

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

duplicate()

Duplique l'élément de la page.

L'élément de page dupliqué est placé sur la même page, au même emplacement que l'original.

Renvois

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getConnectionSites()

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

Renvois

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getDashStyle()

Récupère le DashStyle de la ligne.

Renvois

DashStyle : style de tirets utilisé avec cette ligne.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 scopes suivants :

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

getEnd()

Renvoie le point d'extrémité de la ligne, mesuré à partir de l'angle supérieur gauche de la page.

Renvois

Point : point d'arrivée de la ligne.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getEndArrow()

Obtient le ArrowStyle de la flèche à la fin de la ligne.

Renvois

ArrowStyle : style de la flèche à la fin de cette ligne.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getEndConnection()

Renvoie la connexion à la fin de la ligne ou null s'il n'y a pas de connexion.

Renvois

ConnectionSite|null : connexion à la fin de la ligne.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getHeight()

Obtient la hauteur de l'élément en points, qui correspond à la hauteur du cadre de sélection 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 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|null : 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 scopes suivants :

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

getInherentHeight()

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

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

Renvois

Number|null : 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 scopes 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 intrinsèque en combinaison avec la transformation de l'élément pour déterminer son apparence visuelle finale.

Renvois

Number|null : 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 scopes 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 en rotation.

Renvois

Number : position horizontale de cet élément en points, à partir de l'angle supérieur gauche de la page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getLineCategory()

Récupère le LineCategory de la ligne.

Renvois

LineCategory : catégorie de la ligne.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getLineFill()

Récupère le LineFill de la ligne.

Renvois

LineFill : paramètre de remplissage de cette ligne.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getLineType()

Récupère le LineType de la ligne.

Renvois

LineType : type de ligne.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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|null : Link ou null si aucun lien n'est disponible.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 : identifiant unique de cet objet.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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'un enum 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 scopes 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 n'appartient à aucun groupe.

Renvois

Group|null : 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 scopes 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 scopes suivants :

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

getRotation()

Renvoie l'angle de rotation de l'élément autour de son centre dans le sens des aiguilles d'une montre, en degrés. Zéro degré signifie qu'il n'y a pas de rotation.

Renvois

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getStart()

Renvoie le point de départ de la ligne, mesuré à partir de l'angle supérieur gauche de la page.

Renvois

Point : point de départ de la ligne.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getStartArrow()

Obtient le ArrowStyle de la flèche au début de la ligne.

Renvois

ArrowStyle : style de la flèche au début de cette ligne.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getStartConnection()

Renvoie la connexion au début de la ligne, ou null s'il n'y a pas de connexion.

Renvois

ConnectionSite|null : connexion au début de la ligne.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 scopes suivants :

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

getTop()

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

Renvois

Number : position verticale de l'é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 scopes 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 scopes suivants :

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

getWeight()

Renvoie l'épaisseur de la ligne en points.

Renvois

Number : épaisseur de la ligne en points.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

getWidth()

Renvoie la largeur de l'élément en points, qui correspond à la largeur du cadre de sélection de l'élément lorsque celui-ci n'est pas pivoté.

Cette méthode n'est pas compatible avec tous les éléments de 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|null : 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 scopes suivants :

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

isConnector()

Renvoie true si la ligne est un connecteur, ou false dans le cas contraire.

Un connecteur est un type de ligne utilisé pour relier des sites de connexion sur les éléments de page applicables. Chaque extrémité du connecteur peut être connectée à un seul site de connexion au maximum.

Renvois

Boolean : True si la ligne est un connecteur, ou false si ce n'est pas le cas.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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

Line : 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 scopes suivants :

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

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é d'un modèle ou d'une mise en page, tous les espaces réservés vides hérités sont également supprimés.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

Supprime une Link.

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

reroute()

Redirige le début et la fin de la ligne vers les deux sites de connexion les plus proches sur les éléments de page connectés. Le début et la fin de la ligne doivent être connectés à des éléments de page différents.

Renvois

Line : ligne.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

scaleHeight(ratio)

Met à l'échelle la hauteur de l'élément selon le ratio spécifié. La hauteur de l'élément correspond à la hauteur de son cadre de sélection lorsque l'élément n'est pas en rotation.

Cette méthode n'est pas compatible avec tous les éléments de 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 permettant de mettre à l'échelle la hauteur de cet élément de page.

Renvois

Line : 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 scopes suivants :

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

scaleWidth(ratio)

Met à l'échelle la largeur de l'élément selon le ratio spécifié. La largeur de l'élément correspond à la largeur de son cadre de sélection lorsque l'élément n'est pas pivoté.

Cette méthode n'est pas compatible avec tous les éléments de 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 permettant de mettre à l'échelle la largeur de cet élément de page.

Renvois

Line : 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 scopes 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 à la sélection de l'utilisateur qui l'exécute que s'il est associé à la présentation.

Cela définit le Page parent du PageElement comme 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 scopes 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 à la sélection de l'utilisateur qui l'exécute que s'il est associé à la présentation.

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

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

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

  1. Le parent Page de l'objet PageElement doit être current page selection.
  2. Plusieurs objets Page ne doivent pas être sélectionnés.

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.

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, elle 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 scopes suivants :

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

sendBackward()

Envoie l'élément de page vers l'arrière d'un élément.

L'élément de page ne doit pas se trouver dans un groupe.

Renvois

Line : 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 scopes suivants :

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

sendToBack()

Envoie l'élément de page à l'arrière-plan de la page.

L'élément de page ne doit pas se trouver dans un groupe.

Renvois

Line : 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 scopes suivants :

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

setDashStyle(style)

Définit le DashStyle de la ligne.

Paramètres

NomTypeDescription
styleDashStyleStyle de tirets à définir pour cette ligne.

Renvois

Line : cette ligne, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 permettant de définir la description du texte alternatif.

Renvois

Line : élément de cette page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

setEnd(left, top)

Définit la position du point d'arrivée de la ligne.

Le tracé de la ligne peut être ajusté après le changement de position.

Paramètres

NomTypeDescription
leftNumberPosition horizontale du point d'extrémité de la ligne, mesurée en points à partir de l'angle supérieur gauche de la page.
topNumberPosition 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 : cette ligne, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

setEnd(point)

Définit la position du point d'arrivée de la ligne.

Le tracé de la ligne peut être ajusté après le changement de position.

Paramètres

NomTypeDescription
pointPointPoint d'arrivée de la ligne, dont la position est mesurée à partir de l'angle supérieur gauche de la page.

Renvois

Line : cette ligne, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

setEndArrow(style)

Définit le ArrowStyle de la flèche à la fin de la ligne.

Paramètres

NomTypeDescription
styleArrowStyleStyle à définir.

Renvois

Line : cette ligne, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

setEndConnection(connectionSite)

Définit la connexion à la fin de la ligne. Il déplace l'extrémité de la ligne vers le site de connexion spécifié, tout en conservant l'autre extrémité intacte.

Paramètres

NomTypeDescription
connectionSiteConnectionSiteSite de connexion auquel la connexion de fin est mise à jour, ou null si la connexion de fin est supprimée.

Renvois

Line : ligne.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

setHeight(height)

Définit la hauteur de l'élément en points, qui correspond à la hauteur du cadre de sélection 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 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 l'élément de page à définir, en points.

Renvois

Line : 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 scopes suivants :

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

setLeft(left)

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

Paramètres

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

Renvois

Line : 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 scopes suivants :

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

setLineCategory(lineCategory)

Définit le LineCategory de la ligne.

Vous ne pouvez définir la catégorie que sur connectors. Le connecteur peut être redirigé après le changement de catégorie.

Paramètres

NomTypeDescription
lineCategoryLineCategoryCatégorie de ligne à définir.

Renvois

Line : ligne.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

setLinkSlide(slideIndex)

Définit un Link sur le Slide donné à l'aide de l'index base zéro 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(0);

Paramètres

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

Renvois

Link : le Link qui a été défini.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

setLinkSlide(slide)

Définit un Link sur le Slide donné. Le lien est défini par l'ID de 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 : le Link qui a été défini.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

setLinkSlide(slidePosition)

Définit un Link sur le Slide donné en utilisant la position relative de la diapositive.

// Set a link to the first slide of the presentation.
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 : le Link qui a été défini.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 : le Link qui a été défini.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

setRotation(angle)

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

Cette méthode n'est pas compatible avec tous les éléments de 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

Line : 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 scopes suivants :

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

setStart(left, top)

Définit la position du point de départ de la ligne.

Le tracé de la ligne peut être ajusté après le changement de position.

Paramètres

NomTypeDescription
leftNumberPosition horizontale du point de départ de la ligne, mesurée en points à partir de l'angle supérieur gauche de la page.
topNumberPosition verticale du point de départ de la ligne, mesurée en points à partir de l'angle supérieur gauche de la page.

Renvois

Line : cette ligne, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

setStart(point)

Définit la position du point de départ de la ligne.

Le tracé de la ligne peut être ajusté après le changement de position.

Paramètres

NomTypeDescription
pointPointPoint de départ de la ligne, dont la position est mesurée à partir de l'angle supérieur gauche de la page.

Renvois

Line : cette ligne, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

setStartArrow(style)

Définit le ArrowStyle de la flèche au début de la ligne.

Paramètres

NomTypeDescription
styleArrowStyleNouveau style de flèche à définir.

Renvois

Line : cette ligne, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

setStartConnection(connectionSite)

Définit la connexion au début de la ligne. Il déplace le début de la ligne vers le site de connexion spécifié tout en conservant l'autre extrémité intacte.

Paramètres

NomTypeDescription
connectionSiteConnectionSiteSite de connexion de début auquel la connexion de début est mise à jour, ou null si la connexion de début est supprimée.

Renvois

Line : ligne.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 permettant de définir le titre du texte alternatif.

Renvois

Line : élément de cette page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 pivoté.

Paramètres

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

Renvois

Line : 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 scopes suivants :

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

setTransform(transform)

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

La mise à jour de la transformation d'un groupe modifie la transformation absolue des éléments de la page dans ce groupe, ce qui peut modifier leur apparence visuelle.

La mise à jour de la transformation d'un élément de page qui se trouve dans un groupe ne modifie que la transformation de cet élément de page. Elle n'affecte pas les transformations du groupe ni des 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

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

setWeight(points)

Définit l'épaisseur de la ligne en points.

Paramètres

NomTypeDescription
pointsNumberNouvelle épaisseur de la ligne en points.

Renvois

Line : cette ligne, pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

setWidth(width)

Définit la largeur de l'élément en points, qui correspond à la largeur du cadre de sélection de l'élément lorsque celui-ci n'est pas pivoté.

Cette méthode n'est pas compatible avec tous les éléments de 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 l'élément de page à définir, en points.

Renvois

Line : 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 scopes suivants :

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