Class CellImageBuilder

KomórkaObrazKreator

Konstruktor: CellImage. Ten kreator tworzy wartość obrazu potrzebną do dodania obrazu do komórki.

Właściwości

WłaściwośćTypOpis
valueTypeValueTypeTyp wartości obrazu komórki, który jest ValueType.IMAGE.

Metody

MetodaZwracany typKrótki opis
build()CellImageTworzy typ wartości obrazu potrzebny do dodania obrazu do komórki.
getAltTextDescription()StringZwraca tekst alternatywny dla tego obrazu.
getAltTextTitle()StringZwraca tytuł tekstu alternatywnego dla tego obrazu.
getContentUrl()StringZwraca adres URL obrazu hostowanego przez Google.
setAltTextDescription(description)CellImageUstawia tekst alternatywny dla tego obrazu.
setAltTextTitle(title)CellImageUstawia tytuł tekstu alternatywnego dla tego obrazu.
setSourceUrl(url)CellImageBuilderUstawia adres URL źródła obrazu.
toBuilder()CellImageBuilderTworzy kreator obrazów komórki na podstawie bieżących właściwości obrazu.

Szczegółowa dokumentacja

build()

Tworzy typ wartości obrazu potrzebny do dodania obrazu do komórki. Wartość obrazu jest tworzona na podstawie właściwości obrazu dodanych do kreatora, takich jak adres URL źródłowy.

Powrót

CellImage – reprezentacja obrazu do dodania do komórki.

getAltTextDescription()

Zwraca tekst alternatywny dla tego obrazu.

Powrót

String – tekst alternatywny.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getAltTextTitle()

Zwraca tytuł tekstu alternatywnego dla tego obrazu.

Powrót

String – tytuł tekstu alternatywnego.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getContentUrl()

Zwraca adres URL obrazu hostowanego przez Google. Ten adres URL jest oznaczony tagiem konta osoby, która go poprosiła, więc każdy, kto ma ten adres URL, uzyskuje dostęp do obrazu jako pierwotny żądający. Jeśli ustawienia udostępniania arkusza kalkulacyjnego ulegną zmianie, możesz utracić dostęp do obrazu. Zwrócony adres URL wygasa po krótkim czasie. 

const range = SpreadsheetApp.getActiveSpreadsheet().getRange("Sheet1!A1");
const value = range.getValue();
if (value.valueType == SpreadsheetApp.ValueType.IMAGE) {
  console.log(value.getContentUrl());
}

Powrót

String – adres URL obrazu hostowanego przez Google.

setAltTextDescription(description)

Ustawia tekst alternatywny dla tego obrazu.

Parametry

NazwaTypOpis
descriptionStringNowy tekst alternatywny obrazu.

Powrót

CellImage – ten obraz do łańcucha.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setAltTextTitle(title)

Ustawia tytuł tekstu alternatywnego dla tego obrazu.

Parametry

NazwaTypOpis
titleStringNowy tytuł tekstu alternatywnego obrazu.

Powrót

CellImage – ten obraz do łańcucha.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setSourceUrl(url)

Ustawia adres URL źródła obrazu.

Parametry

NazwaTypOpis
urlStringAdres URL obrazu.

Powrót

CellImageBuilder – ten kreator do łańcuchowania.

toBuilder()

Tworzy kreator obrazów komórki na podstawie bieżących właściwości obrazu. Aby ustawić źródłowy adres URL nowego obrazu, użyj pola setSourceUrl(url). Następnie możesz dodać go do komórki za pomocą funkcji Range.setValue(value) lub 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);
}

Powrót

CellImageBuilder – kreator, który tworzy typ wartości obrazu na podstawie podanych właściwości obrazu.

Wycofane metody