Questa pagina è stata tradotta dall'API Cloud Translation.

Class Drawing

Rappresenta un disegno su un foglio di un foglio di lavoro.

Metodi

Metodo	Tipo restituito	Breve descrizione
`getContainerInfo()`	`ContainerInfo`	Recupera le informazioni sulla posizione del disegno nel foglio.
`getHeight()`	`Integer`	Restituisce l'altezza effettiva del disegno in pixel.
`getOnAction()`	`String`	Restituisce il nome della macro associata a questo disegno.
`getSheet()`	`Sheet`	Restituisce il foglio in cui appare questo disegno.
`getWidth()`	`Integer`	Restituisce la larghezza effettiva del disegno in pixel.
`getZIndex()`	`Number`	Restituisce lo z-index di questo disegno.
`remove()`	`void`	Elimina questo disegno dal foglio di lavoro.
`setHeight(height)`	`Drawing`	Imposta l'altezza effettiva del disegno in pixel.
`setOnAction(macroName)`	`Drawing`	Assegna una funzione macro a questo disegno.
`setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)`	`Drawing`	Imposta la posizione in cui viene visualizzato il disegno sul foglio.
`setWidth(width)`	`Drawing`	Imposta la larghezza effettiva di questo disegno in pixel.
`setZIndex(zIndex)`	`Drawing`	Imposta lo z-index di questo disegno.

Documentazione dettagliata

`getContainerInfo()`

Recupera le informazioni sulla posizione del disegno nel foglio.

Ritorni

ContainerInfo: oggetto che contiene la posizione del contenitore del disegno.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getHeight()`

Restituisce l'altezza effettiva del disegno in pixel.

// 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());
}

Ritorni

Integer: l'altezza del disegno in pixel.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getOnAction()`

Restituisce il nome della macro associata a questo disegno.

// 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());
}

Ritorni

String: il nome della macro associato a questo disegno.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSheet()`

Restituisce il foglio in cui appare questo disegno.

// 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());
}

Ritorni

Sheet: il foglio su cui viene visualizzato il disegno.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getWidth()`

Restituisce la larghezza effettiva del disegno in pixel.

// 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());
}

Ritorni

Integer: la larghezza del disegno in pixel.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getZIndex()`

Restituisce lo z-index di questo disegno.

// 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());
}

Ritorni

Number: Z-Index di questo disegno.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`remove()`

Elimina questo disegno dal foglio di lavoro. Qualsiasi altra operazione sul disegno genera un errore di script.

// Deletes all drawings from the active sheet.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
  drawings[i].remove();
}

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setHeight(height)`

Imposta l'altezza effettiva del disegno in pixel.

Parametri

Nome	Tipo	Descrizione
`height`	`Integer`	L'altezza desiderata in pixel.

Ritorni

Drawing - Questo disegno, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setOnAction(macroName)`

Assegna una funzione macro a questo disegno.

Parametri

Nome	Tipo	Descrizione
`macroName`	`String`	Nome della funzione macro.

Ritorni

Drawing - Questo disegno, per il concatenamento.

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

Imposta la posizione in cui viene visualizzato il disegno sul foglio. Gli indici della riga di ancoraggio e della posizione della colonna sono indicizzati 1.

Parametri

Nome	Tipo	Descrizione
`anchorRowPos`	`Integer`	Il lato superiore del disegno è ancorato a questa riga.
`anchorColPos`	`Integer`	Il lato superiore del disegno è ancorato in questa colonna.
`offsetX`	`Integer`	Lo scostamento orizzontale dall'angolo della cella in pixel.
`offsetY`	`Integer`	Lo scostamento verticale dall'angolo della cella in pixel.

Ritorni

Drawing - Questo disegno, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setWidth(width)`

Imposta la larghezza effettiva di questo disegno in pixel.

Parametri

Nome	Tipo	Descrizione
`width`	`Integer`	La larghezza desiderata in pixel.

Ritorni

Drawing - Questo disegno, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setZIndex(zIndex)`

Imposta lo z-index di questo disegno.

Parametri

Nome	Tipo	Descrizione
`zIndex`	`Number`	Z-Index di questo disegno.

Ritorni

Drawing - Questo disegno, per il concatenamento.