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 informazioni sulla posizione del disegno nel foglio.
`getHeight()`	`Integer`	Restituisce l'altezza effettiva del disegno in pixel.
`getOnAction()`	`String`	Restituisce il nome della macro allegata a questo disegno.
`getSheet()`	`Sheet`	Restituisce il foglio in cui compare il disegno.
`getWidth()`	`Integer`	Restituisce la larghezza effettiva del disegno in pixel.
`getZIndex()`	`Number`	Restituisce lo z-index del disegno.
`remove()`	`void`	Elimina questo disegno dal foglio di lavoro.
`setHeight(height)`	`Drawing`	Consente di impostare 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 nel foglio.
`setWidth(width)`	`Drawing`	Consente di impostare la larghezza effettiva di questo disegno in pixel.
`setZIndex(zIndex)`	`Drawing`	Imposta lo z-index di questo disegno.

Documentazione dettagliata

`getContainerInfo()`

Recupera informazioni sulla posizione del disegno nel foglio.

Invio

ContainerInfo: un oggetto contenente 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());
}

Invio

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

Invio

String: il nome della macro associato al 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 compare il 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());
}

Invio

Sheet: il foglio in 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());
}

Invio

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

Invio

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 ulteriore operazione sul disegno determina 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)`

Consente di impostare l'altezza effettiva del disegno in pixel.

Parametri

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

Invio

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.

Invio

Drawing: questo disegno, per il concatenamento.

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

Imposta la posizione in cui viene visualizzato il disegno nel foglio. Posizione della riga e della colonna ancorate sono 1-indicizzati.

Parametri

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

Invio

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)`

Consente di impostare la larghezza effettiva di questo disegno in pixel.

Parametri

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

Invio

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.

Invio

Drawing: questo disegno, per il concatenamento.