Class CellImage

CellImage

Rappresenta un'immagine da aggiungere a una cella. Per aggiungere un'immagine a una cella, devi creare un nuovo valore dell'immagine utilizzando SpreadsheetApp.newCellImage() e CellImageBuilder. Poi puoi utilizzare 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 per questa immagine.
getAltTextTitle()StringRestituisce il titolo del testo alternativo per questa immagine.
getContentUrl()StringRestituisce un URL dell'immagine ospitato da Google.
getUrl()StringRecupera 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 immagine in modo da poterla inserire in una cellula.

Documentazione dettagliata

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

getContentUrl()

Restituisce un URL dell'immagine ospitato da Google. Questo URL è contrassegnato con l'account dell'utente che ha effettuato la richiesta, quindi chiunque disponga dell'URL accede effettivamente all'immagine come utente che ha effettuato la richiesta originale. L'accesso all'immagine potrebbe andare perso se le impostazioni di condivisione del foglio di lavoro cambiano. L'URL restituito scade dopo un breve periodo di tempo.

Invio

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

getUrl()

Recupera l'URL di origine dell'immagine; restituisce null se l'URL non è disponibile. Se l'immagine è stata inserita tramite 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 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 immagine in modo da poterla inserire in una cellula. Prima di inserire un'immagine in una cella, è necessario crearla come tipo di valore immagine. Dopodiché puoi aggiungerlo a una cella utilizzando Range.setValue(value) o Range.setValues(values).

Invio

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