Class CellImage

CellImage

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

Proprietà

ProprietàTipoDescrizione
valueTypeValueTypeIl tipo di valore dell'immagine della cella, ovvero ValueType.IMAGE.

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 ospitato da Google all'immagine.
toBuilder()CellImageBuilderCrea un generatore di immagini delle celle in base alle proprietà dell'immagine corrente.

Documentazione dettagliata

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.

toBuilder()

Crea un generatore di immagini delle celle in base alle proprietà dell'immagine corrente. Utilizza CellImageBuilder.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