Cette page a été traduite par l'API Cloud Translation.

Class Drawing

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.