Costruttore per Cell
. Questo generatore crea il valore dell'immagine necessario per aggiungere un'immagine a una cella.
Proprietà
Proprietà | Tipo | Descrizione |
---|---|---|
value | Value | Il tipo di valore dell'immagine della cella, ovvero Value . |
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
build() | Cell | Crea il tipo di valore immagine necessario per aggiungere un'immagine a una cella. |
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. |
set | Cell | Imposta la descrizione del testo alternativo per questa immagine. |
set | Cell | Imposta il titolo del testo alternativo per questa immagine. |
set | Cell | Imposta l'URL dell'origine dell'immagine. |
to | Cell | Crea un generatore di immagini delle celle in base alle proprietà immagine correnti. |
Metodi ritirati
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
| String | Recupera l'URL di origine dell'immagine. |
Documentazione dettagliata
build()
Crea il tipo di valore immagine necessario per aggiungere un'immagine a una cella. Il valore dell'immagine viene creato dalle proprietà dell'immagine aggiunte al generatore, ad esempio l'URL di origine.
Invio
Cell
: una rappresentazione dell'immagine da aggiungere a una cella.
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, pertanto 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 ospitata da Google.
setAltTextDescription(description)
Imposta la descrizione del testo alternativo per questa immagine.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
description | String | La nuova descrizione del testo alternativo per l'immagine. |
Invio
Cell
: questa immagine, per l'accodamento.
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
Nome | Tipo | Descrizione |
---|---|---|
title | String | Il nuovo titolo del testo alternativo per l'immagine. |
Invio
Cell
: questa immagine, per l'accodamento.
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
setSourceUrl(url)
Imposta l'URL dell'origine dell'immagine.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
url | String | L'URL dell'immagine. |
Invio
Cell
: questo generatore, per l'accodamento.
toBuilder()
Crea un generatore di immagini delle celle in base alle proprietà immagine correnti. Utilizza set
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.
Metodi ritirati
getUrl()
getUrl()
Ritiro. Per la maggior parte delle immagini appena inserite, l'URL di origine non è disponibile.
Recupera l'URL di origine dell'immagine. Restituisce una stringa vuota se l'URL non è disponibile. Per la maggior parte delle immagini appena inserite, l'URL di origine non è disponibile, indipendentemente dal modo in cui l'immagine viene inserita.
Invio
String
: l'URL di origine dell'immagine, se disponibile; in caso contrario, restituisce una stringa vuota.
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