Class CellImage

KomórkaObraz

Reprezentuje wartość obrazu w komórce. Aby dodać obraz do komórki, musisz utworzyć nową wartość obrazu za pomocą elementów SpreadsheetApp.newCellImage() i CellImageBuilder. Następnie możesz użyć funkcji Range.setValue(value) lub Range.setValues(values), aby dodać wartość obrazu do komórki.

Właściwości

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

Metody

Metoda	Zwracany typ	Krótki opis
getAltTextDescription()	String	Zwraca tekst alternatywny dla tego obrazu.
getAltTextTitle()	String	Zwraca tytuł tekstu alternatywnego dla tego obrazu.
getContentUrl()	String	Zwraca adres URL obrazu hostowanego przez Google.
toBuilder()	CellImageBuilder	Tworzy kreator obrazów komórki 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

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.

---

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 CellImageBuilder.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

getUrl()

Wycofany. 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. W przypadku większości nowo wstawionych obrazów adres URL źródłowy jest niedostępny niezależnie od sposobu wstawienia obrazu.

Powrót

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

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