Class CellImageBuilder

CellImageBuilder

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

Właściwości

Właściwość	Typ	Opis
valueType	ValueType	Typ wartości obrazu komórki, czyli ValueType.IMAGE.

Metody

Metoda	Zwracany typ	Krótki opis
build()	CellImage	Tworzy typ wartości obrazu potrzebny do dodania obrazu do komórki.
getAltTextDescription()	String	Zwraca tekst alternatywny tego obrazu.
getAltTextTitle()	String	Zwraca tytuł tekstu alternatywnego tego obrazu.
getContentUrl()	String	Zwraca adres URL obrazu hostowanego w Google.
setAltTextDescription(description)	CellImage	Ustawia tekst alternatywny dla tego obrazu.
setAltTextTitle(title)	CellImage	Ustawia tytuł tekstu alternatywnego dla tego obrazu.
setSourceUrl(url)	CellImageBuilder	Ustawia adres URL źródła obrazu.
toBuilder()	CellImageBuilder	Tworzy narzędzie do tworzenia obrazów komórek na podstawie bieżących właściwości obrazu.

Wycofane metody

Metoda	Zwracany typ	Krótki opis
getUrl()	String	Pobiera adres URL źródła 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 narzędzia do tworzenia, takich jak adres URL źródła.

Powrót

CellImage – reprezentacja obrazu, który ma zostać dodany do komórki.

---

getAltTextDescription()

Zwraca tekst alternatywny tego obrazu.

Powrót

String – tekst alternatywny opisu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

---

getAltTextTitle()

Zwraca tytuł tekstu alternatywnego tego obrazu.

Powrót

String – tytuł tekstu alternatywnego.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

---

getContentUrl()

Zwraca adres URL obrazu hostowanego w Google. Ten adres URL jest oznaczony kontem osoby wysyłającej żądanie, więc każdy, kto ma ten adres URL, uzyskuje dostęp do obrazu jako pierwotny wnioskodawca. Dostęp do obrazu może zostać utracony, jeśli zmienią się ustawienia udostępniania arkusza kalkulacyjnego. 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

Nazwa	Typ	Opis
description	String	Nowy tekst alternatywny obrazu.

Powrót

CellImage – ten obraz do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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

Nazwa	Typ	Opis
title	String	Nowy tytuł tekstu alternatywnego obrazu.

Powrót

CellImage – ten obraz do łączenia.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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

Nazwa	Typ	Opis
url	String	Adres URL obrazu.

Powrót

CellImageBuilder – ten kreator do łączenia.

---

toBuilder()

Tworzy narzędzie do tworzenia obrazów komórek na podstawie bieżących właściwości obrazu. Użyj kodu setSourceUrl(url), aby ustawić adres URL źródła nowego obrazu. 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

getUrl()

Wycofano. W przypadku większości nowo wstawionych obrazów adres URL źródła jest niedostępny.

Pobiera adres URL źródła obrazu. Jeśli adres URL jest niedostępny, zwraca pusty ciąg znaków. W przypadku większości nowo wstawionych obrazów adres URL źródła jest niedostępny niezależnie od sposobu wstawienia obrazu.

Powrót

String – adres URL źródła obrazu, jeśli jest dostępny; w przeciwnym razie zwraca pusty ciąg znaków.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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