Élément PageElement
représentant une table.
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
alignOnPage(alignmentPosition) | Table | Aligne l'élément selon la position d'alignement spécifiée sur la page. |
appendColumn() | TableColumn | Ajoute une nouvelle colonne à droite de la dernière colonne de la table. |
appendRow() | TableRow | Ajoute une nouvelle ligne sous la dernière ligne de la table. |
bringForward() | Table | Affiche l'élément de page d'un élément vers l'avant sur la page. |
bringToFront() | Table | Place l'élément de page au début de la page. |
duplicate() | PageElement | Duplique l'élément de page. |
getCell(rowIndex, columnIndex) | TableCell | Renvoie la cellule spécifiée dans le tableau. |
getColumn(columnIndex) | TableColumn | Renvoie la colonne spécifiée dans la table. |
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. |
getDescription() | String | Renvoie la description du texte alternatif de l'élément de page. |
getHeight() | Number | Récupère la hauteur de l'élément en points, qui correspond à la hauteur du cadre de délimitation de l'élément lorsqu'il 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 page lorsque l'élément n'a pas de rotation. |
getNumColumns() | Integer | Renvoie le nombre de colonnes dans la table. |
getNumRows() | Integer | Renvoie le nombre de lignes de la table. |
getObjectId() | String | Renvoie l'identifiant unique de cet objet. |
getPageElementType() | PageElementType | Renvoie le type de l'élément de page, représenté par une énumération PageElementType . |
getParentGroup() | Group | Renvoie le groupe auquel appartient cet élément de page ou null si l'élément ne fait pas partie d'un 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é signifie qu'il n'y a pas de rotation. |
getRow(rowIndex) | TableRow | Renvoie la ligne spécifiée dans la table. |
getTitle() | String | Renvoie 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. |
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 celui-ci n'a pas de rotation. |
insertColumn(index) | TableColumn | Insère une nouvelle colonne à l'index spécifié de la table. |
insertRow(index) | TableRow | Insère une nouvelle ligne à l'index spécifié de la table. |
preconcatenateTransform(transform) | Table | Préconcatène la transformation fournie avec la transformation existante de l'élément de page. |
remove() | void | Supprime l'élément de page. |
scaleHeight(ratio) | Table | Met à l'échelle la hauteur de l'élément selon le ratio spécifié. |
scaleWidth(ratio) | Table | Met à l'échelle la largeur de l'élément selon le ratio spécifié. |
select() | void | Sélectionne uniquement l'élément PageElement dans la présentation active et supprime toute sélection précédente. |
select(replace) | void | Sélectionne PageElement dans la présentation active. |
sendBackward() | Table | Renvoie l'élément de page vers l'arrière sur la page d'un élément. |
sendToBack() | Table | Envoie l'élément de page au dos de la page. |
setDescription(description) | Table | Définit la description du texte alternatif de l'élément de page. |
setHeight(height) | Table | Définit la hauteur de l'élément en points, qui correspond à la hauteur du cadre de délimitation de l'élément lorsqu'il n'a pas de rotation. |
setLeft(left) | Table | 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'a pas de rotation. |
setRotation(angle) | Table | Définit l'angle de rotation de l'élément dans le sens des aiguilles d'une montre autour de son centre, en degrés. |
setTitle(title) | Table | Définit le titre du texte alternatif de l'élément de page. |
setTop(top) | Table | 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) | Table | Définit la transformation de l'élément de page avec la transformation fournie. |
setWidth(width) | Table | Définit la largeur de l'élément en points, qui correspond à la largeur du cadre de délimitation de l'élément lorsqu'il n'a pas de rotation. |
Documentation détaillée
alignOnPage(alignmentPosition)
Aligne l'élément selon 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
Table
: cet élément de page, pour le chaînage.
appendColumn()
Ajoute une nouvelle colonne à droite de la dernière colonne de la table.
Renvois
TableColumn
: nouvelle colonne ajoutée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
appendRow()
Ajoute une nouvelle ligne sous la dernière ligne de la table.
Renvois
TableRow
: nouvelle ligne ajoutée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
bringForward()
Affiche l'élément de page d'un élément vers l'avant sur la page.
L'élément de page ne doit pas appartenir à un groupe.
Renvois
Table
: cet élément de page, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
bringToFront()
Place l'élément de page au début de la page.
L'élément de page ne doit pas appartenir à un groupe.
Renvois
Table
: cet élément de page, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 en double est placé sur la même page, à la même position que l'élément d'origine.
Renvois
PageElement
: nouveau doublon de cet élément de page.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getCell(rowIndex, columnIndex)
Renvoie la cellule spécifiée dans le tableau.
Paramètres
Nom | Type | Description |
---|---|---|
rowIndex | Integer | Index de ligne de la cellule à récupérer. |
columnIndex | Integer | Index de colonne de la cellule à récupérer. |
Renvois
TableCell
: cellule récupérée dans la table.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getColumn(columnIndex)
Renvoie la colonne spécifiée dans la table.
Paramètres
Nom | Type | Description |
---|---|---|
columnIndex | Integer | Index de colonne de base 0. |
Renvois
TableColumn
: colonne récupérée de la table.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getConnectionSites()
Renvoie la liste des ConnectionSite
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 ne comporte aucun site de connexion.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getDescription()
Renvoie la description du texte alternatif de l'élément de page. La description est combinée au titre pour afficher et lire le texte alternatif.
Renvois
String
: description du texte alternatif de l'élément de page.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 du cadre de délimitation de l'élément lorsqu'il 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 compatibles avec cette méthode, consultez 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 n'a pas de hauteur.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 associée à 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 n'a pas de hauteur.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 associée à 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 n'a pas de largeur.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLeft()
Renvoie la position horizontale de l'élément en points, mesurée à partir de l'angle supérieur gauche de la page lorsque l'élément n'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 associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getNumColumns()
Renvoie le nombre de colonnes dans la table.
Renvois
Integer
: nombre de colonnes dans ce tableau.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getNumRows()
Renvoie le nombre de lignes de la table.
Renvois
Integer
: nombre de lignes dans ce tableau.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 même espace de noms.
Renvois
String
: identifiant unique de cet objet.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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é par une énumération PageElementType
.
Renvois
PageElementType
: type de l'élément de page.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentGroup()
Renvoie le groupe auquel appartient cet élément de page ou null
si l'élément ne fait pas partie d'un groupe.
Renvois
Group
: groupe auquel appartient cet élément de page, ou null
.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getRotation()
Renvoie l'angle de rotation de l'élément dans le sens des aiguilles d'une montre autour de son centre, en degrés, où zéro degré signifie 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 associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getRow(rowIndex)
Renvoie la ligne spécifiée dans la table.
Paramètres
Nom | Type | Description |
---|---|---|
rowIndex | Integer | Index de la ligne à récupérer. |
Renvois
TableRow
: ligne de la table récupérée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTitle()
Renvoie le titre du texte alternatif de l'élément de page. Le titre est combiné à la description pour afficher et lire le texte alternatif.
Renvois
String
: titre du texte alternatif de l'élément de page.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTransform()
Renvoie la transformation de l'élément de page.
L'apparence visuelle de l'élément de page est déterminée par sa transformation absolue. Pour calculer la transformation absolue, préconcaténez la transformation d'un élément de page avec les transformations de tous ses groupes parents. Si l'élément de page ne se trouve pas dans 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 associée à 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 celui-ci 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 compatibles avec cette méthode, consultez 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 n'a pas de largeur.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertColumn(index)
Insère une nouvelle colonne à l'index spécifié de la table.
Si toutes les cellules de la colonne située à gauche de l'index spécifié sont fusionnées avec d'autres colonnes, la nouvelle colonne est insérée à droite des colonnes communes couvertes par ces cellules.
Paramètres
Nom | Type | Description |
---|---|---|
index | Integer | Index auquel insérer une nouvelle colonne. |
Renvois
TableColumn
: nouvelle colonne insérée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertRow(index)
Insère une nouvelle ligne à l'index spécifié de la table.
Si toutes les cellules de la ligne située au-dessus de l'index spécifié sont fusionnées avec d'autres lignes, la nouvelle ligne est insérée sous les lignes communes réparties par ces cellules.
Paramètres
Nom | Type | Description |
---|---|---|
index | Integer | Index auquel insérer une nouvelle ligne. |
Renvois
TableRow
: nouvelle ligne insérée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 avec la transformation existante de l'élément de page.
newTransform = argument * existingTransform
Par exemple, pour déplacer les éléments d'une 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 dans la transformation de cet élément de page. |
Renvois
Table
: cet élément de page, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 seul élément de page ou aucun, le groupe lui-même est également supprimé.
Si un espace réservé PageElement
est supprimé d'une page maître 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 associée à 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 selon le ratio spécifié. La hauteur de l'élément correspond à la hauteur de son cadre de délimitation lorsqu'il n'est pas soumis à une rotation.
Cette méthode n'est pas compatible avec tous les éléments de la page. Pour savoir quels éléments de page ne sont pas compatibles avec cette méthode, consultez les limites de taille et de positionnement.
Paramètres
Nom | Type | Description |
---|---|---|
ratio | Number | Ratio de mise à l'échelle de la hauteur de cet élément de page. |
Renvois
Table
: cet élément de page, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 lorsqu'il 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 compatibles avec cette méthode, consultez les limites de taille et de positionnement.
Paramètres
Nom | Type | Description |
---|---|---|
ratio | Number | Ratio de mise à l'échelle de la largeur de cet élément de page. |
Renvois
Table
: cet élément de page, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 l'élément PageElement
dans la présentation active et supprime toute sélection précédente. Cela revient à appeler select(replace)
avec true
.
Un script ne peut accéder qu'à la sélection de l'utilisateur qui l'exécute, et uniquement s'il 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 associée à 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 PageElement
dans la présentation active.
Un script ne peut accéder qu'à la sélection de l'utilisateur qui l'exécute, et uniquement s'il est lié à la présentation.
Transmettez true
à cette méthode pour ne sélectionner que PageElement
et supprimer toute 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
. Les objets PageElement
doivent se trouver dans le même Page
.
Lorsque vous sélectionnez un élément de page à l'aide d'un paramètre false
, les conditions suivantes doivent être remplies:
- La
Page
parente de l'objetPageElement
doit être lacurrent page selection
. - Vous ne devez pas sélectionner plusieurs objets
Page
.
Pour vous en assurer, l'approche privilégiée consiste à sélectionner d'abord le Page
parent à l'aide de Page.selectAsCurrentPage()
, puis à sélectionner 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, elle est ajoutée à toute sélection précédente. |
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendBackward()
Renvoie l'élément de page vers l'arrière sur la page d'un élément.
L'élément de page ne doit pas appartenir à un groupe.
Renvois
Table
: cet élément de page, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 au dos de la page.
L'élément de page ne doit pas appartenir à un groupe.
Renvois
Table
: cet élément de page, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 sur laquelle définir la description du texte alternatif. |
Renvois
Table
: cet élément de page.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 du cadre de délimitation de l'élément lorsqu'il 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 compatibles avec cette méthode, consultez 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
Table
: cet élément de page, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 page lorsque l'élément n'a pas de rotation.
Paramètres
Nom | Type | Description |
---|---|---|
left | Number | Nouvelle position horizontale à définir, en points. |
Renvois
Table
: cet élément de page, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setRotation(angle)
Définit l'angle de rotation de l'élément dans le sens des aiguilles d'une montre autour de son centre, en degrés.
Cette méthode n'est pas compatible avec tous les éléments de la page. Pour savoir quels éléments de page ne sont pas compatibles avec cette méthode, consultez les limites de 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
Table
: cet élément de page, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 définir le titre du texte alternatif. |
Renvois
Table
: cet élément de page.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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
Table
: cet élément de page, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 page de ce groupe, ce qui peut modifier leur apparence visuelle.
La mise à jour de la transformation d'un élément de page faisant partie d'un groupe ne modifie que la transformation de cet élément de page. Elle n'a aucune incidence sur les transformations du groupe ni sur les autres éléments de page du groupe.
Pour en savoir plus sur l'impact des transformations sur l'apparence visuelle des éléments de la page, consultez getTransform()
.
Paramètres
Nom | Type | Description |
---|---|---|
transform | AffineTransform | Transformation définie pour cet élément de page. |
Renvois
Table
: cet élément, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 du cadre de délimitation de l'élément lorsqu'il 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 compatibles avec cette méthode, consultez les limites de taille et de positionnement.
Paramètres
Nom | Type | Description |
---|---|---|
width | Number | Nouvelle largeur à définir de cet élément de page, en points. |
Renvois
Table
: cet élément de page, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations