Class Drawing

Disegno

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 di questo disegno in pixel.
getOnAction()	String	Restituisce il nome della macro associata a questo disegno.
getSheet()	Sheet	Restituisce il foglio in cui viene visualizzato il disegno.
getWidth()	Integer	Restituisce la larghezza effettiva di questo disegno in pixel.
getZIndex()	Number	Restituisce lo z-index di questo disegno.
remove()	void	Elimina il disegno dal foglio di lavoro.
setHeight(height)	Drawing	Imposta l'altezza effettiva del disegno in pixel.
setOnAction(macroName)	Drawing	Assegna una funzione di macro a questo disegno.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)	Drawing	Imposta la posizione in cui viene visualizzato il disegno nel foglio.
setWidth(width)	Drawing	Imposta la larghezza effettiva del disegno in pixel.
setZIndex(zIndex)	Drawing	Imposta l'indice z di questo disegno.

Documentazione dettagliata

getContainerInfo()

Recupera le 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 di questo disegno in pixel.

// Logs the height of all drawings in a sheet
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let 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 associata a questo disegno.

// Logs the macro name of all drawings on the active sheet.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getOnAction());
}

Invio

String: il nome della macro associata 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 viene visualizzato il disegno.

// Logs the parent sheet of all drawings on the active sheet.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getSheet());
}

Invio

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 di questo disegno in pixel.

// Logs the width of all drawings in a sheet
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let 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 di questo disegno.

// Logs the z-index of all drawings on the active sheet.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getZIndex());
}

Invio

Number: l'indice Z 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 il disegno dal foglio di lavoro. Qualsiasi operazione successiva sul disegno comporta un errore dello script.

// Deletes all drawings from the active sheet.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let 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.

Invio

Drawing: questo disegno, per l'accoppiamento.

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 di macro a questo disegno.

Parametri

Nome	Tipo	Descrizione
macroName	String	Nome della funzione della macro.

Invio

Drawing: questo disegno, per l'accoppiamento.

---

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Imposta la posizione in cui viene visualizzato il disegno nel foglio. Gli indici di posizione della riga e della colonna di ancoraggio sono indicizzati da 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 dal angolo della cella in pixel.
offsetY	Integer	Lo scostamento verticale dal angolo della cella in pixel.

Invio

Drawing: questo disegno, per l'accoppiamento.

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 del disegno in pixel.

Parametri

Nome	Tipo	Descrizione
width	Integer	La larghezza desiderata in pixel.

Invio

Drawing: questo disegno, per l'accoppiamento.

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 l'indice z di questo disegno.

Parametri

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

Invio

Drawing: questo disegno, per l'accoppiamento.