Class OverGridImage

SopraGrigliaImmagine

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 lo scostamento orizzontale in pixel dalla cella di ancoraggio.
getAnchorCellYOffset()	Integer	Restituisce lo scostamento verticale in pixel dalla cella di ancoraggio.
getHeight()	Integer	Restituisce l'altezza effettiva dell'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 l'immagine.
getWidth()	Integer	Restituisce la larghezza effettiva dell'immagine in pixel.
remove()	void	Consente di eliminare questa immagine dal foglio di lavoro.
replace(blob)	OverGridImage	Sostituisce questa immagine con quella specificata dal valore 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 a cui è ancorata un'immagine.
setAnchorCellXOffset(offset)	OverGridImage	Imposta lo scostamento orizzontale in pixel dalla cella di ancoraggio.
setAnchorCellYOffset(offset)	OverGridImage	Imposta lo scostamento 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 dell'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 di primo livello pubblica, non una che termina con un trattino basso, come privateFunction_.

Invio

OverGridImage: questa immagine, per l'accodamento.

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.

Invio

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.

Invio

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.

Invio

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 lo scostamento orizzontale in pixel dalla cella di ancoraggio.

Invio

Integer: l'offset orizzontale dei 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 lo scostamento verticale in pixel dalla cella di ancoraggio.

Invio

Integer: l'offset dei pixel verticali.

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

Invio

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.

Invio

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.

Invio

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.

Invio

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

Invio

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

Invio

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

Consente di eliminare questa immagine dal foglio di lavoro. Qualsiasi operazione successiva 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 valore BlobSource fornito. Il limite massimo per le dimensioni del blob supportate è 2 MB.

Parametri

Nome	Tipo	Descrizione
blob	BlobSource	La nuova immagine come blob.

Invio

OverGridImage: questa immagine, per l'accodamento.

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.

Invio

OverGridImage: questa immagine, per l'accodamento.

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.

Invio

OverGridImage: questa immagine, per l'accodamento.

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.

Invio

OverGridImage: questa immagine, per l'accodamento.

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.

Invio

OverGridImage: questa immagine, per l'accodamento.

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 a cui è ancorata un'immagine.

Parametri

Nome	Tipo	Descrizione
cell	Range	La nuova cella di ancoraggio.

Invio

OverGridImage: questa immagine, per l'accodamento.

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 lo scostamento orizzontale in pixel dalla cella di ancoraggio.

Parametri

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

Invio

OverGridImage: questa immagine, per l'accodamento.

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 lo scostamento verticale in pixel dalla cella di ancoraggio.

Parametri

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

Invio

OverGridImage: questa immagine, per l'accodamento.

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.

Invio

OverGridImage: l'immagine per l'accodamento.

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

Parametri

Nome	Tipo	Descrizione
width	Integer	La larghezza desiderata in pixel.

Invio

OverGridImage: l'immagine per l'accodamento.

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

Ritiro. 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 appena inserite, l'URL di origine non è disponibile, indipendentemente dal modo in cui l'immagine viene inserita.

Invio

String: l'URL di origine dell'immagine, se disponibile; in caso contrario, 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