Questa pagina è stata tradotta dall'API Cloud Translation.

Class 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 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