Rappresenta un valore immagine in una cella. Per aggiungere un'immagine a una cella, devi creare un nuovo valore dell'immagine per l'immagine utilizzando Spreadsheet
e Cell
. Poi puoi utilizzare Range.setValue(value)
o Range.setValues(values)
per
aggiungere il valore dell'immagine alla cella.
Proprietà
Proprietà | Tipo | Descrizione |
---|---|---|
value | Value | Il tipo di valore dell'immagine della cella, ovvero Value . |
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
get | String | Restituisce la descrizione del testo alternativo per questa immagine. |
get | String | Restituisce il titolo del testo alternativo per questa immagine. |
get | String | Restituisce un URL dell'immagine ospitato da Google. |
to | Cell | Crea un generatore di immagini delle celle in base alle proprietà immagine correnti. |
Documentazione dettagliata
get Alt Text Description()
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
get Alt Text Title()
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
get Content Url()
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.
const range = SpreadsheetApp.getActiveSpreadsheet().getRange("Sheet1!A1"); const value = range.getValue(); if (value.valueType == SpreadsheetApp.ValueType.IMAGE) { console.log(value.getContentUrl()); }
Invio
String
: l'URL dell'immagine ospitato da Google.
to Builder()
Crea un generatore di immagini delle celle in base alle proprietà immagine correnti. Utilizza Cell
per impostare l'URL di origine della nuova immagine. Dopodiché puoi aggiungerlo a una cella utilizzando Range.setValue(value)
o Range.setValues(values)
.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const range = ss.getRange("Sheet1!A1"); const value = range.getValue(); if (value.valueType == SpreadsheetApp.ValueType.IMAGE) { const newImage = value.toBuilder() .setSourceUrl( 'https://www.gstatic.com/images/branding/productlogos/apps_script/v10/web-64dp/logo_apps_script_color_1x_web_64dp.png', ) .build(); const newRange = ss.getRange("Sheet1!A2"); newRange.setValue(newImage); }
Invio
Cell
: un generatore che crea un tipo di valore immagine in base alle proprietà dell'immagine specificate.