Class OverGridImage

OverGridImage

Rappresenta un'immagine sulla griglia di un foglio di lavoro.

Metodi

MetodoTipo restituitoBreve descrizione
assignScript(functionName)OverGridImageAssegna la funzione con il nome specificato a questa immagine.
getAltTextDescription()StringRestituisce la descrizione del testo alternativo per l'immagine.
getAltTextTitle()StringRestituisce il titolo del testo alternativo per l'immagine.
getAnchorCell()RangeRestituisce la cella in cui è ancorata un'immagine.
getAnchorCellXOffset()IntegerRestituisce l'offset di pixel orizzontale dalla cella di ancoraggio.
getAnchorCellYOffset()IntegerRestituisce l'offset di pixel verticale dalla cella di ancoraggio.
getHeight()IntegerRestituisce l'altezza effettiva dell'immagine in pixel.
getInherentHeight()IntegerRestituisce l'altezza intrinseca dell'immagine in pixel.
getInherentWidth()IntegerRestituisce l'altezza intrinseca dell'immagine in pixel.
getScript()StringRestituisce il nome della funzione assegnata a questa immagine.
getSheet()SheetRestituisce il foglio su cui viene visualizzata l'immagine.
getUrl()StringOttiene l'URL di origine dell'immagine; restituisce null se l'URL non è disponibile.
getWidth()IntegerRestituisce la larghezza effettiva dell'immagine in pixel.
remove()voidElimina l'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 l'immagine sulle sue dimensioni intrinseche.
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 in cui è ancorata un'immagine.
setAnchorCellXOffset(offset)OverGridImageImposta l'offset di pixel orizzontale dalla cella di ancoraggio.
setAnchorCellYOffset(offset)OverGridImageImposta l'offset di pixel verticale dalla cella di ancoraggio.
setHeight(height)OverGridImageConsente di impostare l'altezza effettiva dell'immagine in pixel.
setWidth(width)OverGridImageConsente di impostare la larghezza effettiva dell'immagine in pixel.

Documentazione dettagliata

assignScript(functionName)

Assegna la funzione con il nome specificato a questa immagine.

Parametri

NomeTipoDescrizione
functionNameStringIl nome della funzione specificata. Deve essere un livello pubblico di primo livello , non una che termina con il trattino basso come privateFunction_.

Invio

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 per l'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 l'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 l'offset di pixel orizzontale dalla cella di ancoraggio.

Invio

Integer: l'offset di pixel orizzontale.

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 l'offset di pixel verticale dalla cella di ancoraggio.

Invio

Integer: l'offset di pixel verticale.

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

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 dell'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 dell'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 su cui viene visualizzata l'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());
}

Invio

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

Ottiene l'URL di origine dell'immagine; restituisce null se l'URL non è disponibile. Se l'immagine fosse inserito dall'URL utilizzando un'API, questo metodo restituisce l'URL fornito durante l'inserimento dell'immagine.

Invio

String: l'URL dell'immagine, se disponibile. restituisce null se l'immagine non è disponibile dispongono di 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());
}

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

Elimina l'immagine dal foglio di lavoro. Qualsiasi ulteriore operazione sull'immagine determina la creazione di uno 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 valore BlobSource fornito. Il valore massimo la dimensione del blob supportata è di 2 MB.

Parametri

NomeTipoDescrizione
blobBlobSourceLa nuova immagine è un BLOB.

Invio

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.

Invio

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 sulle sue dimensioni intrinseche.

Invio

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 del testo alternativo per questa immagine.

Parametri

NomeTipoDescrizione
descriptionStringLa nuova descrizione del testo alternativo dell'immagine.

Invio

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 del testo alternativo dell'immagine.

Invio

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.

Invio

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

Parametri

NomeTipoDescrizione
offsetIntegerIl nuovo offset di pixel orizzontale.

Invio

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

Parametri

NomeTipoDescrizione
offsetIntegerIl nuovo offset di pixel verticale.

Invio

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)

Consente di impostare l'altezza effettiva dell'immagine in pixel.

Parametri

NomeTipoDescrizione
heightIntegerL'altezza desiderata in pixel.

Invio

OverGridImage: l'immagine per il collegamento.

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)

Consente di impostare la larghezza effettiva dell'immagine in pixel.

Parametri

NomeTipoDescrizione
widthIntegerLa larghezza desiderata in pixel.

Invio

OverGridImage: l'immagine per il collegamento.

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