Rappresenta un'immagine sopra la griglia in un foglio di lavoro.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
assignScript(functionName) | OverGridImage | Assegna la funzione con il nome della funzione specificato a questa immagine. |
getAltTextDescription() | String | Restituisce la descrizione del testo alternativo dell'immagine. |
getAltTextTitle() | String | Restituisce il titolo del testo alternativo dell'immagine. |
getAnchorCell() | Range | Restituisce la cella in cui è ancorata un'immagine. |
getAnchorCellXOffset() | Integer | Restituisce lo spostamento orizzontale di pixel dalla cella di ancoraggio. |
getAnchorCellYOffset() | Integer | Restituisce lo spostamento di pixel verticale 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 appare questa immagine. |
getUrl() | String | Restituisce l'URL di origine dell'immagine; restituisce null se l'URL non è disponibile. |
getWidth() | Integer | Restituisce la larghezza effettiva dell'immagine in pixel. |
remove() | void | Elimina questa immagine dal foglio di lavoro. |
replace(blob) | OverGridImage | Sostituisce questa immagine con quella specificata dal criterio BlobSource fornito. |
replace(url) | OverGridImage | Sostituisce questa immagine con quella dell'URL specificato. |
resetSize() | OverGridImage | Reimposta l'immagine alle dimensioni intrinseche. |
setAltTextDescription(description) | OverGridImage | Imposta la descrizione in testo alternativo dell'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 di pixel dalla cella di ancoraggio. |
setAnchorCellYOffset(offset) | OverGridImage | Imposta l'offset verticale dei pixel dalla cella di ancoraggio. |
setHeight(height) | OverGridImage | Imposta l'altezza effettiva dell'immagine in pixel. |
setWidth(width) | OverGridImage | Imposta la larghezza effettiva dell'immagine in pixel. |
Documentazione dettagliata
assignScript(functionName)
Assegna la funzione con il nome della funzione specificato a questa immagine.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
functionName | String | Il nome della funzione specificata. Deve essere una funzione di primo livello pubblica, non una funzione che termina con un trattino basso come privateFunction_ . |
Ritorni
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 dell'immagine.
Ritorni
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 dell'immagine.
Ritorni
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.
Ritorni
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 spostamento orizzontale di pixel dalla cella di ancoraggio.
Ritorni
Integer
: 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 spostamento di pixel verticale dalla cella di ancoraggio.
Ritorni
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 dell'immagine in pixel.
// Logs the height of all images in a spreadsheet var images = SpreadsheetApp.getActiveSpreadsheet().getImages(); for (var i = 0; i < images.length; i++) { Logger.log(images[i].getHeight()); }
Ritorni
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.
Ritorni
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.
Ritorni
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.
Ritorni
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 appare questa immagine.
// Logs the parent sheet of all images in a spreadsheet var images = SpreadsheetApp.getActiveSpreadsheet().getImages(); for (var i = 0; i < images.length; i++) { Logger.log(images[i].getSheet()); }
Ritorni
Sheet
: il foglio su 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
getUrl()
Restituisce l'URL di origine dell'immagine; restituisce null
se l'URL non è disponibile. Se l'immagine è stata inserita da un URL utilizzando un'API, questo metodo restituisce l'URL fornito durante l'inserimento dell'immagine.
Ritorni
String
: l'URL dell'immagine se disponibile; restituisce null
se l'immagine non è disponibile o non ha un URL di origine.
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 var images = SpreadsheetApp.getActiveSpreadsheet().getImages(); for (var i = 0; i < images.length; i++) { Logger.log(images[i].getWidth()); }
Ritorni
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 altra operazione sull'immagine genera un errore di script.
// Deletes all images in a spreadsheet var images = SpreadsheetApp.getActiveSpreadsheet().getImages(); for (var 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 criterio BlobSource
fornito. Le dimensioni massime
supportate per il blob sono 2 MB.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
blob | BlobSource | La nuova immagine come Blob. |
Ritorni
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. |
Ritorni
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 l'immagine alle dimensioni intrinseche.
Ritorni
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 in testo alternativo dell'immagine.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
description | String | La nuova descrizione del testo alternativo dell'immagine. |
Ritorni
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 di testo alternativo dell'immagine. |
Ritorni
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. |
Ritorni
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 di pixel dalla cella di ancoraggio.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
offset | Integer | Il nuovo offset di pixel orizzontale. |
Ritorni
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 dei pixel dalla cella di ancoraggio.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
offset | Integer | Il nuovo offset di pixel verticale. |
Ritorni
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 dell'immagine in pixel.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
height | Integer | L'altezza desiderata in pixel. |
Ritorni
OverGridImage
: l'immagine del 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 dell'immagine in pixel.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
width | Integer | La larghezza desiderata in pixel. |
Ritorni
OverGridImage
: l'immagine del 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