Class OverGridImage

SopraGrigliaImmagine

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

Metodi

MetodoTipo restituitoBreve descrizione
assignScript(functionName)OverGridImageAssegna a questa immagine la funzione con il nome specificato.
getAltTextDescription()StringRestituisce la descrizione del testo alternativo per questa immagine.
getAltTextTitle()StringRestituisce il titolo del testo alternativo per questa immagine.
getAnchorCell()RangeRestituisce la cella in cui è ancorata un'immagine.
getAnchorCellXOffset()IntegerRestituisce lo scostamento orizzontale in pixel dalla cella di ancoraggio.
getAnchorCellYOffset()IntegerRestituisce lo scostamento verticale in pixel dalla cella di ancoraggio.
getHeight()IntegerRestituisce l'altezza effettiva dell'immagine in pixel.
getInherentHeight()IntegerRestituisce l'altezza intrinseca di questa immagine in pixel.
getInherentWidth()IntegerRestituisce l'altezza intrinseca di questa immagine in pixel.
getScript()StringRestituisce il nome della funzione assegnata a questa immagine.
getSheet()SheetRestituisce il foglio in cui viene visualizzata l'immagine.
getWidth()IntegerRestituisce la larghezza effettiva dell'immagine in pixel.
remove()voidConsente di eliminare questa immagine dal foglio di lavoro.
replace(blob)OverGridImageSostituisce questa immagine con quella specificata dal valore BlobSource fornito.
replace(url)OverGridImageSostituisce questa immagine con quella dell'URL specificato.
resetSize()OverGridImageReimposta le dimensioni intrinseche dell'immagine.
setAltTextDescription(description)OverGridImageImposta la descrizione del testo alternativo per questa immagine.
setAltTextTitle(title)OverGridImageImposta il titolo del testo alternativo per questa immagine.
setAnchorCell(cell)OverGridImageImposta la cella a cui è ancorata un'immagine.
setAnchorCellXOffset(offset)OverGridImageImposta lo scostamento orizzontale in pixel dalla cella di ancoraggio.
setAnchorCellYOffset(offset)OverGridImageImposta lo scostamento verticale in pixel dalla cella di ancoraggio.
setHeight(height)OverGridImageImposta l'altezza effettiva di questa immagine in pixel.
setWidth(width)OverGridImageImposta la larghezza effettiva dell'immagine in pixel.

Documentazione dettagliata

assignScript(functionName)

Assegna a questa immagine la funzione con il nome specificato.

Parametri

NomeTipoDescrizione
functionNameStringIl 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

NomeTipoDescrizione
blobBlobSourceLa 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

NomeTipoDescrizione
urlStringL'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

NomeTipoDescrizione
descriptionStringLa 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

NomeTipoDescrizione
titleStringIl 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

NomeTipoDescrizione
cellRangeLa 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

NomeTipoDescrizione
offsetIntegerIl 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

NomeTipoDescrizione
offsetIntegerIl 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

NomeTipoDescrizione
heightIntegerL'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

NomeTipoDescrizione
widthIntegerLa 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