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 l'emplacement 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 du dessin 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 l'emplacement du dessin dans la feuille.

Aller-retour

ContainerInfo : objet contenant la position du conteneur du dessin.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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());
}

Aller-retour

Integer : hauteur du dessin en pixels.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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());
}

Aller-retour

String : nom de la macro associée à ce dessin.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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());
}

Aller-retour

Sheet : feuille dans laquelle le dessin apparaît.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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());
}

Aller-retour

Integer : largeur du dessin en pixels.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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());
}

Aller-retour

Number : z-index de ce dessin.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 une 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 avec 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.

Aller-retour

Drawing : ce dessin est enchaîné.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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.

Aller-retour

Drawing : ce dessin est enchaîné.

`setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)`

Définit la position du dessin sur la feuille. Les indices de position des lignes et des colonnes d'ancrage sont indexés sur 1.

Paramètres

Nom	Type	Description
`anchorRowPos`	`Integer`	Le dessus du dessin est ancré dans cette ligne.
`anchorColPos`	`Integer`	Le dessus du dessin est ancré dans ce col.
`offsetX`	`Integer`	Décalage horizontal en pixels par rapport à l'angle de la cellule.
`offsetY`	`Integer`	Décalage vertical par rapport à l'angle de la cellule, en pixels.

Aller-retour

Drawing : ce dessin est enchaîné.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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.

Aller-retour

Drawing : ce dessin est enchaîné.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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.

Aller-retour

Drawing : ce dessin est enchaîné.