Class CellImageBuilder

CellImageBuilder

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

Proprietà

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

Metodi

MetodoTipo restituitoBreve descrizione
build()CellImageCrea il tipo di valore immagine necessario per aggiungere un'immagine a una cella.
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.
setAltTextDescription(description)CellImageImposta la descrizione del testo alternativo per questa immagine.
setAltTextTitle(title)CellImageImposta il titolo del testo alternativo per questa immagine.
setSourceUrl(url)CellImageBuilderImposta l'URL dell'origine dell'immagine.
toBuilder()CellImageBuilderCrea un generatore di immagini delle celle in base alle proprietà immagine correnti.

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

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

NomeTipoDescrizione
descriptionStringLa nuova descrizione del testo alternativo per l'immagine.

Invio

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

NomeTipoDescrizione
titleStringIl nuovo titolo del testo alternativo per l'immagine.

Invio

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

NomeTipoDescrizione
urlStringL'URL dell'immagine.

Invio

CellImageBuilder: questo generatore, per l'accodamento.


toBuilder()

Crea un generatore di immagini delle celle in base alle proprietà immagine correnti. 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);
}

Invio

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

Metodi ritirati