PageElement
représentant une ligne.
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
alignOnPage(alignmentPosition) | Line | Aligne l'élément sur la position d'alignement spécifiée sur la page. |
bringForward() | Line | Met en avant l'élément d'un élément sur la page. |
bringToFront() | Line | Affiche l'élément de page au début de la page. |
duplicate() | PageElement | Duplique 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() | DashStyle | Récupère le DashStyle de la ligne. |
getDescription() | String | Renvoie la description du texte alternatif de l'élément de page. |
getEnd() | Point | Renvoie le point final de la ligne, mesuré à partir de l'angle supérieur gauche de la page. |
getEndArrow() | ArrowStyle | Récupère l'ArrowStyle de la flèche à la fin de la ligne. |
getEndConnection() | ConnectionSite | Renvoie la connexion à la fin de la ligne, ou null en l'absence de connexion. |
getHeight() | Number | 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. |
getInherentHeight() | Number | Renvoie la hauteur inhérente à l'élément en points. |
getInherentWidth() | Number | Renvoie la largeur inhérente à l'élément en points. |
getLeft() | Number | 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. |
getLineCategory() | LineCategory | Récupère le LineCategory de la ligne. |
getLineFill() | LineFill | Récupère le LineFill de la ligne. |
getLineType() | LineType | Récupère le LineType de la ligne. |
getLink() | Link | Renvoie Link ou null en l'absence de lien. |
getObjectId() | String | Renvoie l'identifiant unique de cet objet. |
getPageElementType() | PageElementType | Renvoie le type de l'élément de page, représenté sous forme d'énumération PageElementType . |
getParentGroup() | Group | Affiche le groupe auquel appartient cet élément de page, ou null si l'élément ne se trouve pas dans une
groupe. |
getParentPage() | Page | Affiche la page sur laquelle se trouve cet élément de page. |
getRotation() | Number | 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. |
getStart() | Point | Affiche le point de départ de la ligne, mesuré à partir de l'angle supérieur gauche de la page. |
getStartArrow() | ArrowStyle | Récupère le ArrowStyle de la flèche au début de la ligne. |
getStartConnection() | ConnectionSite | Renvoie la connexion au début de la ligne, ou null en l'absence de connexion. |
getTitle() | String | Affiche le titre du texte alternatif de l'élément de page. |
getTop() | Number | 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. |
getTransform() | AffineTransform | Renvoie la transformation de l'élément de page. |
getWeight() | Number | Renvoie l'épaisseur de la ligne en points. |
getWidth() | Number | 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. |
isConnector() | Boolean | Renvoie true s'il s'agit d'un connecteur, ou false dans le cas contraire. |
preconcatenateTransform(transform) | Line | Préconcatène la transformation fournie dans la transformation existante de l'élément de page. |
remove() | void | Supprime l'élément de page. |
removeLink() | void | Supprime un élément Link . |
reroute() | Line | Redirige le début et la fin de la ligne vers les deux points de connexion les plus proches éléments de page. |
scaleHeight(ratio) | Line | Met à l'échelle la hauteur de l'élément en fonction du ratio spécifié. |
scaleWidth(ratio) | Line | Met à l'échelle la largeur de l'élément selon le ratio spécifié. |
select() | void | Sélectionne uniquement les PageElement dans la présentation active et supprime tous les éléments précédents
de votre choix. |
select(replace) | void | Sélectionne le PageElement dans la présentation active. |
sendBackward() | Line | Déplace l'élément de page d'un élément vers l'arrière. |
sendToBack() | Line | Envoie l'élément de page vers le bas de la page. |
setDashStyle(style) | Line | Définit le DashStyle de la ligne. |
setDescription(description) | Line | Définit la description du texte alternatif de l'élément de page. |
setEnd(left, top) | Line | Définit la position du point d'arrivée de la ligne. |
setEnd(point) | Line | Définit la position du point d'arrivée de la ligne. |
setEndArrow(style) | Line | Définit le ArrowStyle de la flèche à la fin de la ligne. |
setEndConnection(connectionSite) | Line | Définit la connexion à la fin de la ligne. |
setHeight(height) | Line | 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. |
setLeft(left) | Line | 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. |
setLineCategory(lineCategory) | Line | Définit le LineCategory de la ligne. |
setLinkSlide(slideIndex) | Link | Définit un Link sur la Slide donnée à l'aide de l'index de base zéro de la diapositive. |
setLinkSlide(slide) | Link | Définit un Link sur le Slide donné, le lien est défini par l'ID de la diapositive donné. |
setLinkSlide(slidePosition) | Link | Définit un Link sur le Slide donné en utilisant la position relative de la diapositive. |
setLinkUrl(url) | Link | Définit un Link sur la chaîne d'URL non vide fournie. |
setRotation(angle) | Line | 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. |
setStart(left, top) | Line | Définit la position du point de départ de la ligne. |
setStart(point) | Line | Définit la position du point de départ de la ligne. |
setStartArrow(style) | Line | Définit le ArrowStyle de la flèche au début de la ligne. |
setStartConnection(connectionSite) | Line | Définit la connexion au début de la ligne. |
setTitle(title) | Line | Définit le titre du texte alternatif de l'élément de page. |
setTop(top) | Line | 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. |
setTransform(transform) | Line | Définit la transformation de l'élément de page avec la transformation fournie. |
setWeight(points) | Line | Définit l'épaisseur de la ligne en points. |
setWidth(width) | Line | 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. |
Documentation détaillée
alignOnPage(alignmentPosition)
Aligne l'élément sur la position d'alignement spécifiée sur la page.
Paramètres
Nom | Type | Description |
---|---|---|
alignmentPosition | AlignmentPosition | Position à 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
getLink()
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
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
Nom | Type | Description |
---|---|---|
transform | AffineTransform | Transformation à 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
removeLink()
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
Nom | Type | Description |
---|---|---|
ratio | Number | Ratio 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
Nom | Type | Description |
---|---|---|
ratio | Number | Ratio 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
:
- Le
Page
parent de l'objetPageElement
doit être l'current page selection
. - 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
Nom | Type | Description |
---|---|---|
replace | Boolean | Si 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
Nom | Type | Description |
---|---|---|
style | DashStyle | Style 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
Nom | Type | Description |
---|---|---|
description | String | Chaî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
Nom | Type | Description |
---|---|---|
left | Number | Position horizontale du point d'arrivée de la ligne, mesurée en points à partir du dans le coin supérieur gauche de la page. |
top | Number | Position verticale du point d'arrivée de la ligne, mesurée en points à partir du dans le coin supérieur gauche de la page. |
Renvois
Line
: ligne 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
Nom | Type | Description |
---|---|---|
point | Point | Point 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
Nom | Type | Description |
---|---|---|
style | ArrowStyle | Style à 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
Nom | Type | Description |
---|---|---|
connectionSite | ConnectionSite | Le 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
Nom | Type | Description |
---|---|---|
height | Number | Nouvelle 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
Nom | Type | Description |
---|---|---|
left | Number | Nouvelle 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
Nom | Type | Description |
---|---|---|
lineCategory | LineCategory | Caté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
Nom | Type | Description |
---|---|---|
slideIndex | Integer | L'indice basé sur zéro à la diapositive. |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
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
Nom | Type | Description |
---|---|---|
slide | Slide | Slide à associer. |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
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
Nom | Type | Description |
---|---|---|
slidePosition | SlidePosition | La valeur SlidePosition relative. |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
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
Nom | Type | Description |
---|---|---|
url | String | Chaîne de l'URL. |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
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
Nom | Type | Description |
---|---|---|
angle | Number | Nouvel 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
Nom | Type | Description |
---|---|---|
left | Number | Position 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. |
top | Number | Position 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
Nom | Type | Description |
---|---|---|
point | Point | Point 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
Nom | Type | Description |
---|---|---|
style | ArrowStyle | Nouveau 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
Nom | Type | Description |
---|---|---|
connectionSite | ConnectionSite | Le 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
Nom | Type | Description |
---|---|---|
title | String | Chaî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
Nom | Type | Description |
---|---|---|
top | Number | Nouvelle 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
Nom | Type | Description |
---|---|---|
transform | AffineTransform | Transformation 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
Nom | Type | Description |
---|---|---|
points | Number | Nouvelle é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
Nom | Type | Description |
---|---|---|
width | Number | Nouvelle 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