Class CellImage

CellImage

Rappresenta un'immagine da aggiungere a una cella. Per aggiungere un'immagine a una cella, devi creare un nuovo valore immagine per l'immagine utilizzando SpreadsheetApp.newCellImage() e CellImageBuilder. Poi puoi usare Range.setValue(value) o Range.setValues(values) per aggiungere il valore dell'immagine alla cella.

Proprietà

ProprietàTipoDescrizione
valueTypeValueTypeUn campo impostato su ValueType.IMAGE, che rappresenta il tipo di valore dell'immagine.

Metodi

MetodoTipo restituitoBreve descrizione
getAltTextDescription()StringRestituisce la descrizione del testo alternativo dell'immagine.
getAltTextTitle()StringRestituisce il titolo del testo alternativo dell'immagine.
getContentUrl()StringRestituisce un URL ospitato da Google per l'immagine.
getUrl()StringRestituisce l'URL di origine dell'immagine; restituisce null se l'URL non è disponibile.
toBuilder()CellImageBuilderCrea un generatore che trasforma un'immagine in un tipo di valore dell'immagine per poterla inserire in una cella.

Documentazione dettagliata

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

getContentUrl()

Restituisce un URL ospitato da Google per l'immagine. Questo URL è codificato con l'account del richiedente, pertanto chiunque abbia l'URL accede di fatto all'immagine come richiedente originale. Se le impostazioni di condivisione del foglio di lavoro vengono modificate, l'accesso all'immagine potrebbe andare perso. L'URL restituito scade dopo un breve periodo di tempo.

Ritorni

String: l'URL dell'immagine ospitato da Google.


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

toBuilder()

Crea un generatore che trasforma un'immagine in un tipo di valore dell'immagine per poterla inserire in una cella. Prima di poter inserire un'immagine in una cella, devi crearla come tipo di valore dell'immagine. Dopodiché puoi aggiungerlo a una cella utilizzando Range.setValue(value) o Range.setValues(values).

Ritorni

CellImageBuilder: un generatore che crea un tipo di valore dell'immagine in base alle proprietà dell'immagine specificate.