Class OverGridImage

OverGridImage

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

Metodi

MetodoTipo restituitoBreve descrizione
assignScript(functionName)OverGridImageAssegna la funzione con il nome della funzione specificato a questa immagine.
getAltTextDescription()StringRestituisce la descrizione del testo alternativo dell'immagine.
getAltTextTitle()StringRestituisce il titolo del testo alternativo dell'immagine.
getAnchorCell()RangeRestituisce la cella in cui è ancorata un'immagine.
getAnchorCellXOffset()IntegerRestituisce lo spostamento orizzontale di pixel dalla cella di ancoraggio.
getAnchorCellYOffset()IntegerRestituisce lo spostamento di pixel verticale 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 appare questa immagine.
getUrl()StringRestituisce l'URL di origine dell'immagine; restituisce null se l'URL non è disponibile.
getWidth()IntegerRestituisce la larghezza effettiva dell'immagine in pixel.
remove()voidElimina questa immagine dal foglio di lavoro.
replace(blob)OverGridImageSostituisce questa immagine con quella specificata dal criterio BlobSource fornito.
replace(url)OverGridImageSostituisce questa immagine con quella dell'URL specificato.
resetSize()OverGridImageReimposta l'immagine alle dimensioni intrinseche.
setAltTextDescription(description)OverGridImageImposta la descrizione in testo alternativo dell'immagine.
setAltTextTitle(title)OverGridImageImposta il titolo del testo alternativo per questa immagine.
setAnchorCell(cell)OverGridImageImposta la cella in cui è ancorata un'immagine.
setAnchorCellXOffset(offset)OverGridImageImposta l'offset orizzontale di pixel dalla cella di ancoraggio.
setAnchorCellYOffset(offset)OverGridImageImposta l'offset verticale dei pixel dalla cella di ancoraggio.
setHeight(height)OverGridImageImposta l'altezza effettiva dell'immagine in pixel.
setWidth(width)OverGridImageImposta la larghezza effettiva dell'immagine in pixel.

Documentazione dettagliata

assignScript(functionName)

Assegna la funzione con il nome della funzione specificato a questa immagine.

Parametri

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

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

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

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

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

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

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

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

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

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