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()LineMet en avant l'élément d'un élément sur la page.
bringToFront()LineAffiche l'élément de page au début de la page.
duplicate()PageElementDuplique l'élément de page.
getConnectionSites()ConnectionSite[]Renvoie la liste des valeurs ConnectionSite sur l'élément de page ou une liste vide si la 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 final de la ligne, mesuré à partir de l'angle supérieur gauche de la page.
getEndArrow()ArrowStyleRécupère l'ArrowStyle de la flèche à la fin de la ligne.
getEndConnection()ConnectionSiteRenvoie la connexion à la fin de la ligne, ou null en l'absence de connexion.
getHeight()NumberRécupère la hauteur de l'élément en points, qui correspond à la hauteur de la boîte englobante de l'élément lorsque n'a pas de rotation.
getInherentHeight()NumberRenvoie la hauteur inhérente à l'élément en points.
getInherentWidth()NumberRenvoie la largeur inhérente à 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 lorsque l'élément n'a pas de 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()LinkRenvoie Link ou null en l'absence de lien.
getObjectId()StringRenvoie l'identifiant unique de cet objet.
getPageElementType()PageElementTypeRenvoie le type de l'élément de page, représenté sous forme d'énumération PageElementType.
getParentGroup()GroupAffiche le groupe auquel appartient cet élément de page, ou null si l'élément ne se trouve pas dans une groupe.
getParentPage()PageAffiche 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és signifie pas de rotation.
getStart()PointAffiche le point de départ de la ligne, mesuré à partir de l'angle supérieur gauche de la page.
getStartArrow()ArrowStyleRécupère le ArrowStyle de la flèche au début de la ligne.
getStartConnection()ConnectionSiteRenvoie la connexion au début de la ligne, ou null en l'absence de connexion.
getTitle()StringAffiche 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 de l'angle supérieur gauche de la page. lorsque l'élément n'a pas de rotation.
getTransform()AffineTransformRenvoie la transformation de l'élément de page.
getWeight()NumberRenvoie l'épaisseur de la ligne en points.
getWidth()NumberRenvoie la largeur de l'élément en points, qui correspond à la largeur du cadre de délimitation de l'élément lorsque l'élément n'a pas de rotation.
isConnector()BooleanRenvoie true s'il s'agit d'un connecteur, ou false dans le cas contraire.
preconcatenateTransform(transform)LinePréconcatène la transformation fournie dans la transformation existante de l'élément de page.
remove()voidSupprime l'élément de page.
removeLink()voidSupprime un élément Link.
reroute()LineRedirige le début et la fin de la ligne vers les deux points de connexion les plus proches éléments de page.
scaleHeight(ratio)LineMet à l'échelle la hauteur de l'élément en fonction du ratio spécifié.
scaleWidth(ratio)LineMet à l'échelle la largeur de l'élément selon le ratio spécifié.
select()voidSélectionne uniquement les PageElement dans la présentation active et supprime tous les éléments précédents de votre choix.
select(replace)voidSélectionne le PageElement dans la présentation active.
sendBackward()LineDéplace l'élément de page d'un élément vers l'arrière.
sendToBack()LineEnvoie l'élément de page vers le bas 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 de son cadre de délimitation lorsque n'a pas de 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 lorsque l'élément n'a pas de rotation.
setLineCategory(lineCategory)LineDéfinit le LineCategory de la ligne.
setLinkSlide(slideIndex)LinkDéfinit un Link sur la Slide donnée à l'aide de l'index de 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 la 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 fournie.
setRotation(angle)LineDéfinit l'angle de rotation de l'élément autour de son centre, en degrés, dans le sens des aiguilles d'une montre.
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 de l'angle supérieur gauche de la page. lorsque l'élément n'a pas de rotation.
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 de son cadre de délimitation lorsque n'a pas de rotation.

Documentation détaillée

alignOnPage(alignmentPosition)

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

Paramètres

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

Renvois

Line : cet élément de page, pour l'enchaînement.


bringForward()

Met en avant l'élément d'un élément sur la page.

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

Renvois

Line : cet élément de page, pour l'enchaînement.

Autorisation

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

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

bringToFront()

Affiche l'élément de page au début de la page.

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

Renvois

Line : cet élément de page, pour l'enchaînement.

Autorisation

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

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

duplicate()

Duplique l'élément de page.

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

Renvois

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

Autorisation

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

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

getConnectionSites()

Renvoie la liste des valeurs ConnectionSite sur l'élément de page ou une liste vide si la 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 correspondant à un ou plusieurs des champs d'application 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 tiret utilisé pour cette ligne.

Autorisation

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

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

getDescription()

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

Renvois

String : texte alternatif descriptif de l'élément de page.

Autorisation

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

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

getEnd()

Renvoie le point final 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 correspondant à un ou plusieurs des champs d'application suivants:

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

getEndArrow()

Récupère l'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 correspondant à un ou plusieurs des champs d'application 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 en l'absence de connexion.

Renvois

ConnectionSite : connexion en fin de ligne.

Autorisation

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

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

getHeight()

Récupère la hauteur de l'élément en points, qui correspond à la hauteur de la boîte englobante de l'élément lorsque n'a pas de rotation.

Cette méthode n'est pas compatible avec tous les éléments de la page. Pour savoir quels éléments de page ne sont pas compatible avec cette méthode, reportez-vous à la les limites de taille et de positionnement.

Renvois

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

Autorisation

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

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

getInherentHeight()

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

La transformation de l'élément de page dépend de sa taille inhérente. Utilisez la taille inhérente dans conjointement avec la transformation de l'élément pour déterminer son apparence visuelle finale.

Renvois

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

Autorisation

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

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

getInherentWidth()

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

La transformation de l'élément de page dépend de sa taille inhérente. Utilisez la taille inhérente dans conjointement avec la transformation de l'élément pour déterminer son apparence visuelle finale.

Renvois

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

Autorisation

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

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

getLeft()

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

Renvois

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

Autorisation

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

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

getLineCategory()

Récupère le LineCategory de la ligne.

Renvois

LineCategory : catégorie de ligne.

Autorisation

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

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

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 correspondant à un ou plusieurs des champs d'application 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 la ligne.

Autorisation

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

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

Renvoie Link ou null en l'absence de lien.

var link = shape.getLink();
if (link != null) {
  Logger.log('Shape has a link of type: ' + link.getLinkType());
}

Renvois

Link

Autorisation

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

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

getObjectId()

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

Renvois

String : identifiant unique de cet objet.

Autorisation

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

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

getPageElementType()

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

Renvois

PageElementType : type de l'élément de page.

Autorisation

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

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

getParentGroup()

Affiche le groupe auquel appartient cet élément de page, ou null si l'élément ne se trouve pas dans une groupe.

Renvois

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

Autorisation

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

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

getParentPage()

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

Renvois

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

Autorisation

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

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

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és signifie pas de rotation.

Renvois

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

Autorisation

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

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

getStart()

Affiche 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 correspondant à un ou plusieurs des champs d'application suivants:

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

getStartArrow()

Récupère 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 correspondant à un ou plusieurs des champs d'application 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 en l'absence de connexion.

Renvois

ConnectionSite : connexion en début de ligne.

Autorisation

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

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

getTitle()

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

Renvois

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

Autorisation

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

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

getTop()

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

Renvois

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

Autorisation

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

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

getTransform()

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

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

Renvois

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

Autorisation

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

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

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 correspondant à un ou plusieurs des champs d'application suivants:

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

getWidth()

Renvoie la largeur de l'élément en points, qui correspond à la largeur du cadre de délimitation de l'élément lorsque l'élément n'a pas de rotation.

Cette méthode n'est pas compatible avec tous les éléments de la page. Pour savoir quels éléments de page ne sont pas compatible avec cette méthode, reportez-vous à la les limites de taille et de positionnement.

Renvois

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

Autorisation

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

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

isConnector()

Renvoie true s'il s'agit d'un connecteur, ou false dans le cas contraire.

Le connecteur est un type de ligne utilisé pour connecter des sites de connexion sur la page concernée éléments. Chaque extrémité du connecteur ne peut être connectée qu'à un seul site de connexion.

Renvois

Boolean : True si la ligne est un connecteur, ou false dans le cas contraire.

Autorisation

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

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

preconcatenateTransform(transform)

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

newTransform = argument * existingTransform

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

element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder()
    .setTranslateX(-36.0)
    .build());

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

Paramètres

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

Renvois

Line : cet élément de page, pour l'enchaînement.

Autorisation

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

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

remove()

Supprime l'élément de page.

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

Si un espace réservé PageElement est supprimé d'un maître ou d'une mise en page, tout élément vide héritant les espaces réservés sont également supprimés.

Autorisation

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

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

Supprime un élément Link.

shape.removeLink();

reroute()

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

Renvois

Line : ligne.

Autorisation

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

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

scaleHeight(ratio)

Met à l'échelle la hauteur de l'élément en fonction du ratio spécifié. La hauteur de l'élément correspond à la hauteur cadre de délimitation lorsque l'élément n'a pas de rotation.

Cette méthode n'est pas compatible avec tous les éléments de la page. Pour savoir quels éléments de page ne sont pas compatible avec cette méthode, reportez-vous à la les limites de taille et de positionnement.

Paramètres

NomTypeDescription
ratioNumberRatio utilisé pour mettre à l'échelle la hauteur de cet élément de page.

Renvois

Line : cet élément de page, pour l'enchaînement.

Autorisation

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

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

scaleWidth(ratio)

Met à l'échelle la largeur de l'élément selon le ratio spécifié. La largeur de l'élément correspond à la largeur de son cadre de délimitation lorsque l'élément n'a pas de rotation.

Cette méthode n'est pas compatible avec tous les éléments de la page. Pour savoir quels éléments de page ne sont pas compatible avec cette méthode, reportez-vous à la les limites de taille et de positionnement.

Paramètres

NomTypeDescription
ratioNumberRatio utilisé pour mettre à l'échelle la largeur de cet élément de page.

Renvois

Line : cet élément de page, pour l'enchaînement.

Autorisation

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

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

select()

Sélectionne uniquement les PageElement dans la présentation active et supprime tous les éléments précédents de votre choix. Cela revient à appeler select(replace) avec true.

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

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

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

Autorisation

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

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

select(replace)

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

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

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

Transmettez false pour sélectionner plusieurs objets PageElement. 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 false :

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

Pour ce faire, nous vous recommandons de sélectionner le Page parent. commencez par utiliser Page.selectAsCurrentPage(), puis sélectionnez les éléments de cette page.

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

Paramètres

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

Autorisation

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

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

sendBackward()

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

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

Renvois

Line : cet élément de page, pour l'enchaînement.

Autorisation

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

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

sendToBack()

Envoie l'élément de page vers le bas de la page.

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

Renvois

Line : cet élément de page, pour l'enchaînement.

Autorisation

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

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

setDashStyle(style)

Définit le DashStyle de la ligne.

Paramètres

NomTypeDescription
styleDashStyleStyle du tiret à définir pour cette ligne.

Renvois

Line : ligne utilisée pour le chaînage.

Autorisation

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

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

setDescription(description)

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

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

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

Paramètres

NomTypeDescription
descriptionStringChaîne à utiliser pour la description du texte alternatif.

Renvois

Line : cet élément de page.

Autorisation

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

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

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 un changement de position.

Paramètres

NomTypeDescription
leftNumberPosition horizontale du point d'arrivée de la ligne, mesurée en points à partir du dans le coin supérieur gauche de la page.
topNumberPosition verticale du point d'arrivée de la ligne, mesurée en points à partir du dans le coin supérieur gauche de la page.

Renvois

Line : ligne utilisée pour le chaînage.

Autorisation

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

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

setEnd(point)

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

Le tracé de la ligne peut être ajusté après un 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 : ligne utilisée pour le chaînage.

Autorisation

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

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

setEndArrow(style)

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

Paramètres

NomTypeDescription
styleArrowStyleStyle à définir.

Renvois

Line : ligne utilisée pour le chaînage.

Autorisation

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

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

setEndConnection(connectionSite)

Définit la connexion à la fin de la ligne. Cette fonction déplace la fin de la ligne de connexion tout en gardant l’autre extrémité intacte.

Paramètres

NomTypeDescription
connectionSiteConnectionSiteLe site de connexion auquel la connexion de fin est mise à jour, ou null si en supprimant la connexion de fin.

Renvois

Line : ligne.

Autorisation

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

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

setHeight(height)

Définit la hauteur de l'élément en points, qui correspond à la hauteur de son cadre de délimitation lorsque n'a pas de rotation.

Cette méthode n'est pas compatible avec tous les éléments de la page. Pour savoir quels éléments de page ne sont pas compatible avec cette méthode, reportez-vous à la les limites de taille et de positionnement.

Paramètres

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

Renvois

Line : cet élément de page, pour l'enchaînement.

Autorisation

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

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

setLeft(left)

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

Paramètres

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

Renvois

Line : cet élément de page, pour l'enchaînement.

Autorisation

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

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

setLineCategory(lineCategory)

Définit le LineCategory de la ligne.

Vous ne pouvez définir la catégorie que sur connectors. Il est possible que le connecteur réacheminée après avoir changé sa 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 correspondant à un ou plusieurs des champs d'application suivants:

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

setLinkSlide(slideIndex)

Définit un Link sur la Slide donnée à l'aide de l'index de base zéro de la diapositive.

// Set a link to the first slide of the presentation.
shape.setLinkSlide(0);

Paramètres

NomTypeDescription
slideIndexIntegerL'indice basé sur zéro à la diapositive.

Renvois

Link : Link qui a été défini

Autorisation

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

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

setLinkSlide(slide)

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

// Set a link to the first slide of the presentation.
var slide = presentation.getSlides()[0];
shape.setLinkSlide(slide);

Paramètres

NomTypeDescription
slideSlideSlide à associer.

Renvois

Link : Link qui a été défini

Autorisation

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

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

setLinkSlide(slidePosition)

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

// Set a link to the first slide of the presentation.
shape.setLinkSlide(SlideApp.SlidePosition.FIRST_SLIDE);

Paramètres

NomTypeDescription
slidePositionSlidePositionLa valeur SlidePosition relative.

Renvois

Link : Link qui a été défini

Autorisation

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

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

setLinkUrl(url)

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

// Set a link to the URL.
shape.setLinkUrl("https://slides.google.com");

Paramètres

NomTypeDescription
urlStringChaîne de l'URL.

Renvois

Link : Link qui a été défini

Autorisation

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

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

setRotation(angle)

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

Cette méthode n'est pas compatible avec tous les éléments de la page. Pour savoir quels éléments de page ne sont pas compatible avec cette méthode, reportez-vous à la les limites de taille 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 l'enchaînement.

Autorisation

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

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

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 un changement de position.

Paramètres

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

Renvois

Line : ligne utilisée pour le chaînage.

Autorisation

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

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

setStart(point)

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

Le tracé de la ligne peut être ajusté après un 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 : ligne utilisée pour le chaînage.

Autorisation

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

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

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 : ligne utilisée pour le chaînage.

Autorisation

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

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

setStartConnection(connectionSite)

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

Paramètres

NomTypeDescription
connectionSiteConnectionSiteLe site de connexion utilisé pour démarrer la connexion, ou null si vous supprimez la connexion de début.

Renvois

Line : ligne.

Autorisation

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

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

setTitle(title)

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

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

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

Paramètres

NomTypeDescription
titleStringChaîne sur laquelle le titre du texte alternatif doit être défini.

Renvois

Line : cet élément de page.

Autorisation

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

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

setTop(top)

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

Paramètres

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

Renvois

Line : cet élément de page, pour l'enchaînement.

Autorisation

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

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

setTransform(transform)

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

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

La mise à jour de la transformation d'un élément de page appartenant à un groupe modifie uniquement la transformation de cet élément de page ; il n'affecte pas les transformations du groupe ou des autres éléments de la page groupe.

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

Paramètres

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

Renvois

Line : élément utilisé pour le chaînage.

Autorisation

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

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

setWeight(points)

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

Paramètres

NomTypeDescription
pointsNumberNouvelle épaisseur de ligne en points.

Renvois

Line : ligne utilisée pour le chaînage.

Autorisation

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

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

setWidth(width)

Définit la largeur de l'élément en points, qui correspond à la largeur de son cadre de délimitation lorsque n'a pas de rotation.

Cette méthode n'est pas compatible avec tous les éléments de la page. Pour savoir quels éléments de page ne sont pas compatible avec cette méthode, reportez-vous à la les limites de taille et de positionnement.

Paramètres

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

Renvois

Line : cet élément de page, pour l'enchaînement.

Autorisation

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

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