Class OverGridImage

OverGridImage

Rappresenta un'immagine sopra la griglia in un foglio di lavoro.

Metodi

Metodo	Tipo restituito	Breve descrizione
assignScript(functionName)	OverGridImage	Assegna a questa immagine la funzione con il nome specificato.
getAltTextDescription()	String	Restituisce la descrizione del testo alternativo per questa immagine.
getAltTextTitle()	String	Restituisce il titolo del testo alternativo per questa immagine.
getAnchorCell()	Range	Restituisce la cella in cui è ancorata un'immagine.
getAnchorCellXOffset()	Integer	Restituisce l'offset orizzontale in pixel dalla cella di ancoraggio.
getAnchorCellYOffset()	Integer	Restituisce l'offset verticale in pixel dalla cella di ancoraggio.
getHeight()	Integer	Restituisce l'altezza effettiva di questa immagine in pixel.
getInherentHeight()	Integer	Restituisce l'altezza intrinseca di questa immagine in pixel.
getInherentWidth()	Integer	Restituisce l'altezza intrinseca di questa immagine in pixel.
getScript()	String	Restituisce il nome della funzione assegnata a questa immagine.
getSheet()	Sheet	Restituisce il foglio in cui viene visualizzata questa immagine.
getWidth()	Integer	Restituisce la larghezza effettiva di questa immagine in pixel.
remove()	void	Elimina questa immagine dal foglio di lavoro.
replace(blob)	OverGridImage	Sostituisce questa immagine con quella specificata dal BlobSource fornito.
replace(url)	OverGridImage	Sostituisce questa immagine con quella dell'URL specificato.
resetSize()	OverGridImage	Reimposta le dimensioni intrinseche dell'immagine.
setAltTextDescription(description)	OverGridImage	Imposta la descrizione del testo alternativo per questa immagine.
setAltTextTitle(title)	OverGridImage	Imposta il titolo del testo alternativo per questa immagine.
setAnchorCell(cell)	OverGridImage	Imposta la cella in cui è ancorata un'immagine.
setAnchorCellXOffset(offset)	OverGridImage	Imposta l'offset orizzontale in pixel dalla cella di ancoraggio.
setAnchorCellYOffset(offset)	OverGridImage	Imposta l'offset verticale in pixel dalla cella di ancoraggio.
setHeight(height)	OverGridImage	Imposta l'altezza effettiva di questa immagine in pixel.
setWidth(width)	OverGridImage	Imposta la larghezza effettiva di questa immagine in pixel.

Metodi ritirati

Metodo	Tipo restituito	Breve descrizione
getUrl()	String	Recupera l'URL di origine dell'immagine.

Documentazione dettagliata

assignScript(functionName)

Assegna a questa immagine la funzione con il nome specificato.

Parametri

Nome	Tipo	Descrizione
functionName	String	Il nome della funzione specificata. Deve essere una funzione pubblica di primo livello, non una che termina con un trattino basso, ad esempio privateFunction_.

Indietro

OverGridImage: questa immagine, 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

---

getAltTextDescription()

Restituisce la descrizione del testo alternativo per questa immagine.

Indietro

String: la descrizione del testo alternativo.

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

---

getAltTextTitle()

Restituisce il titolo del testo alternativo per questa immagine.

Indietro

String: il titolo del testo alternativo.

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

---

getAnchorCell()

Restituisce la cella in cui è ancorata un'immagine.

Indietro

Range: la cella di ancoraggio.

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

---

getAnchorCellXOffset()

Restituisce l'offset orizzontale in pixel dalla cella di ancoraggio.

Indietro

Integer: l'offset orizzontale 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

---

getAnchorCellYOffset()

Restituisce l'offset verticale in pixel dalla cella di ancoraggio.

Indietro

Integer: l'offset verticale 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

---

getHeight()

Restituisce l'altezza effettiva di questa immagine in pixel.

// Logs the height of all images in a spreadsheet
const images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (let i = 0; i < images.length; i++) {
  Logger.log(images[i].getHeight());
}

Indietro

Integer: l'altezza dell'immagine 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

---

getInherentHeight()

Restituisce l'altezza intrinseca di questa immagine in pixel.

Indietro

Integer: l'altezza intrinseca 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

---

getInherentWidth()

Restituisce l'altezza intrinseca di questa immagine in pixel.

Indietro

Integer: la larghezza intrinseca 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

---

getScript()

Restituisce il nome della funzione assegnata a questa immagine.

Indietro

String: il nome della funzione.

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 visualizzata questa immagine.

// Logs the parent sheet of all images in a spreadsheet
const images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (let i = 0; i < images.length; i++) {
  Logger.log(images[i].getSheet());
}

Indietro

Sheet: il foglio in cui viene visualizzata l'immagine.

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 questa immagine in pixel.

// Logs the width of all images in a spreadsheet
const images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (let i = 0; i < images.length; i++) {
  Logger.log(images[i].getWidth());
}

Indietro

Integer: la larghezza dell'immagine 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

---

remove()

Elimina questa immagine dal foglio di lavoro. Qualsiasi ulteriore operazione sull'immagine genera un errore di script.

// Deletes all images in a spreadsheet
const images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (let i = 0; i < images.length; i++) {
  images[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

---

replace(blob)

Sostituisce questa immagine con quella specificata dal BlobSource fornito. La dimensione massima supportata del blob è 2 MB.

Parametri

Nome	Tipo	Descrizione
blob	BlobSource	La nuova immagine come blob.

Indietro

OverGridImage: questa immagine, 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

---

replace(url)

Sostituisce questa immagine con quella dell'URL specificato.

Parametri

Nome	Tipo	Descrizione
url	String	L'URL della nuova immagine.

Indietro

OverGridImage: questa immagine, 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

---

resetSize()

Reimposta le dimensioni intrinseche dell'immagine.

Indietro

OverGridImage: questa immagine, 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

---

setAltTextDescription(description)

Imposta la descrizione del testo alternativo per questa immagine.

Parametri

Nome	Tipo	Descrizione
description	String	La nuova descrizione del testo alternativo per l'immagine.

Indietro

OverGridImage: questa immagine, 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

---

setAltTextTitle(title)

Imposta il titolo del testo alternativo per questa immagine.

Parametri

Nome	Tipo	Descrizione
title	String	Il nuovo titolo del testo alternativo per l'immagine.

Indietro

OverGridImage: questa immagine, 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

---

setAnchorCell(cell)

Imposta la cella in cui è ancorata un'immagine.

Parametri

Nome	Tipo	Descrizione
cell	Range	La nuova cella di ancoraggio.

Indietro

OverGridImage: questa immagine, 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

---

setAnchorCellXOffset(offset)

Imposta l'offset orizzontale in pixel dalla cella di ancoraggio.

Parametri

Nome	Tipo	Descrizione
offset	Integer	Il nuovo offset orizzontale dei pixel.

Indietro

OverGridImage: questa immagine, 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

---

setAnchorCellYOffset(offset)

Imposta l'offset verticale in pixel dalla cella di ancoraggio.

Parametri

Nome	Tipo	Descrizione
offset	Integer	Il nuovo offset verticale dei pixel.

Indietro

OverGridImage: questa immagine, 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

---

setHeight(height)

Imposta l'altezza effettiva di questa immagine in pixel.

Parametri

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

Indietro

OverGridImage: l'immagine 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 questa immagine in pixel.

Parametri

Nome	Tipo	Descrizione
width	Integer	La larghezza desiderata in pixel.

Indietro

OverGridImage: l'immagine 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

Metodi ritirati

getUrl()

Deprecato. Per la maggior parte delle immagini appena inserite, l'URL di origine non è disponibile.

Recupera l'URL di origine dell'immagine. Restituisce una stringa vuota se l'URL non è disponibile. Per la maggior parte delle immagini inserite di recente, l'URL di origine non è disponibile, indipendentemente dalla modalità di inserimento dell'immagine.

Indietro

String: l'URL di origine dell'immagine, se disponibile; altrimenti restituisce una stringa vuota.

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