Class CellImageBuilder

CellImageBuilder

Builder per CellImage. Questo generatore crea il valore dell'immagine necessario per aggiungere un'immagine a una cella.

Proprietà

Proprietà	Tipo	Descrizione
valueType	ValueType	Il tipo di valore dell'immagine della cella, ovvero ValueType.IMAGE.

Metodi

Metodo	Tipo restituito	Breve descrizione
build()	CellImage	Crea il tipo di valore immagine necessario per aggiungere un'immagine a una cella.
getAltTextDescription()	String	Restituisce la descrizione del testo alternativo per questa immagine.
getAltTextTitle()	String	Restituisce il titolo del testo alternativo per questa immagine.
getContentUrl()	String	Restituisce un URL ospitato da Google all'immagine.
setAltTextDescription(description)	CellImage	Imposta la descrizione del testo alternativo per questa immagine.
setAltTextTitle(title)	CellImage	Imposta il titolo del testo alternativo per questa immagine.
setSourceUrl(url)	CellImageBuilder	Imposta l'URL dell'origine dell'immagine.
toBuilder()	CellImageBuilder	Crea un generatore di immagini delle celle in base alle proprietà dell'immagine corrente.

Metodi ritirati

Metodo	Tipo restituito	Breve descrizione
getUrl()	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 a partire dalle proprietà dell'immagine aggiunte al builder, ad esempio l'URL di origine.

Indietro

CellImage: una rappresentazione dell'immagine da aggiungere a una cella.

---

getAltTextDescription()

Restituisce la descrizione del testo alternativo per questa immagine.

Indietro

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.

Indietro

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 all'immagine. Questo URL è taggato con l'account del richiedente, quindi chiunque abbia l'URL accede effettivamente all'immagine come il richiedente originale. L'accesso all'immagine potrebbe essere 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());
}

Indietro

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.

Indietro

CellImage: 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

Nome	Tipo	Descrizione
title	String	Il nuovo titolo del testo alternativo per l'immagine.

Indietro

CellImage: 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

---

setSourceUrl(url)

Imposta l'URL dell'origine dell'immagine.

Parametri

Nome	Tipo	Descrizione
url	String	L'URL dell'immagine.

Indietro

CellImageBuilder: questo generatore, per il concatenamento.

---

toBuilder()

Crea un generatore di immagini delle celle in base alle proprietà dell'immagine corrente. Utilizza setSourceUrl(url) 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);
}

Indietro

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

Metodi ritirati

getUrl()

Deprecato. 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 inserite di recente, l'URL di origine non è disponibile, indipendentemente dalla modalità di inserimento dell'immagine.

Indietro

String: l'URL di origine dell'immagine, se disponibile; altrimenti 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