Représente un dessin sur une feuille d'une feuille de calcul.
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
getContainerInfo() | ContainerInfo | Récupère des informations sur la position du dessin dans la feuille. |
getHeight() | Integer | Renvoie la hauteur réelle de ce dessin en pixels. |
getOnAction() | String | Renvoie le nom de la macro associée à ce dessin. |
getSheet() | Sheet | Affiche la feuille sur laquelle ce dessin apparaît. |
getWidth() | Integer | Renvoie la largeur réelle de ce dessin en pixels. |
getZIndex() | Number | Renvoie le z-index de ce dessin. |
remove() | void | Supprime ce dessin de la feuille de calcul. |
setHeight(height) | Drawing | Définit la hauteur réelle de ce dessin en pixels. |
setOnAction(macroName) | Drawing | Attribue une fonction de macro à ce dessin. |
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY) | Drawing | Définit la position à laquelle le dessin apparaît sur la feuille. |
setWidth(width) | Drawing | Définit la largeur réelle de ce dessin en pixels. |
setZIndex(zIndex) | Drawing | Définit le z-index de ce dessin. |
Documentation détaillée
getContainerInfo()
Récupère des informations sur la position du dessin dans la feuille.
Renvois
ContainerInfo
: objet contenant la position du conteneur du dessin.
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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getHeight()
Renvoie la hauteur réelle de ce dessin en pixels.
// Logs the height of all drawings in a sheet var drawings = SpreadsheetApp.getActiveSheet().getDrawings(); for (var i = 0; i < drawings.length; i++) { Logger.log(drawings[i].getHeight()); }
Renvois
Integer
: hauteur du dessin en pixels.
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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getOnAction()
Renvoie le nom de la macro associée à ce dessin.
// Logs the macro name of all drawings on the active sheet. var drawings = SpreadsheetApp.getActiveSheet().getDrawings(); for (var i = 0; i < drawings.length; i++) { Logger.log(drawings[i].getOnAction()); }
Renvois
String
: nom de la macro associée à ce dessin.
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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheet()
Affiche la feuille sur laquelle ce dessin apparaît.
// Logs the parent sheet of all drawings on the active sheet. var drawings = SpreadsheetApp.getActiveSheet().getDrawings(); for (var i = 0; i < drawings.length; i++) { Logger.log(drawings[i].getSheet()); }
Renvois
Sheet
: feuille sur laquelle le dessin apparaît.
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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWidth()
Renvoie la largeur réelle de ce dessin en pixels.
// Logs the width of all drawings in a sheet var drawings = SpreadsheetApp.getActiveSheet().getDrawings(); for (var i = 0; i < drawings.length; i++) { Logger.log(drawings[i].getWidth()); }
Renvois
Integer
: largeur du dessin en pixels.
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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getZIndex()
Renvoie le z-index de ce dessin.
// Logs the z-index of all drawings on the active sheet. var drawings = SpreadsheetApp.getActiveSheet().getDrawings(); for (var i = 0; i < drawings.length; i++) { Logger.log(drawings[i].getZIndex()); }
Renvois
Number
: z-index de ce dessin.
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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
remove()
Supprime ce dessin de la feuille de calcul. Toute autre opération sur le dessin entraîne erreur de script.
// Deletes all drawings from the active sheet. var drawings = SpreadsheetApp.getActiveSheet().getDrawings(); for (var i = 0; i < drawings.length; i++) { drawings[i].remove(); }
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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setHeight(height)
Définit la hauteur réelle de ce dessin en pixels.
Paramètres
Nom | Type | Description |
---|---|---|
height | Integer | Hauteur souhaitée en pixels. |
Renvois
Drawing
: ce dessin, 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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setOnAction(macroName)
Attribue une fonction de macro à ce dessin.
Paramètres
Nom | Type | Description |
---|---|---|
macroName | String | Nom de la fonction de macro. |
Renvois
Drawing
: ce dessin, utilisé pour le chaînage.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)
Définit la position à laquelle le dessin apparaît sur la feuille. Position d'ancrage de la ligne et de la colonne les index ont un indice de 1.
Paramètres
Nom | Type | Description |
---|---|---|
anchorRowPos | Integer | La partie supérieure du dessin est ancrée dans cette ligne. |
anchorColPos | Integer | La partie supérieure du dessin est ancrée dans cette colonne. |
offsetX | Integer | Décalage horizontal par rapport à l'angle de la cellule, en pixels. |
offsetY | Integer | Décalage vertical par rapport à l'angle de la cellule, en pixels. |
Renvois
Drawing
: ce dessin, 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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWidth(width)
Définit la largeur réelle de ce dessin en pixels.
Paramètres
Nom | Type | Description |
---|---|---|
width | Integer | Largeur souhaitée en pixels. |
Renvois
Drawing
: ce dessin, 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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setZIndex(zIndex)
Définit le z-index de ce dessin.
Paramètres
Nom | Type | Description |
---|---|---|
zIndex | Number | z-index de ce dessin. |
Renvois
Drawing
: ce dessin, utilisé pour le chaînage.