Class CellImage

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Obraz komórkowy

Określa obraz, który chcesz dodać do komórki. Aby dodać obraz do komórki, musisz utworzyć nową wartość obrazu przy użyciu właściwości SpreadsheetApp.newCellImage() i CellImageBuilder. Następnie możesz użyć operatora Range.setValue(value) lub Range.setValues(values), aby dodać do komórki wartość obrazu.

Właściwości

WłaściwośćTypOpis
valueTypeValueTypePole ustawione na ValueType.IMAGE przedstawiające typ wartości obrazu.

Metody

MetodaZwracany typKrótki opis
getAltTextDescription()StringZwraca opis alternatywny tekstu dla tego obrazu.
getAltTextTitle()StringZwraca tytuł alternatywnego tekstu obrazu.
getContentUrl()StringZwraca do obrazu adres URL hostowany przez Google.
getUrl()StringPobiera źródłowy adres URL obrazu; zwraca null, jeśli adres URL jest niedostępny.
toBuilder()CellImageBuilderTworzy konstruktor, który zmienia obraz w typ wartości obrazu, dzięki czemu możesz umieścić go w komórce.

Szczegółowa dokumentacja

getAltTextDescription()

Zwraca opis alternatywny tekstu dla tego obrazu.

Zwróć

String – opis tekstowy alternatywny

Autoryzacja

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

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

getAltTextTitle()

Zwraca tytuł alternatywnego tekstu obrazu.

Zwróć

String – tytuł tekstu alternatywnego.

Autoryzacja

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

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

getContentUrl()

Zwraca do obrazu adres URL hostowany przez Google. Ten adres URL jest tagowany na koncie osoby wysyłającej żądanie, więc każda osoba mająca ten adres URL uzyskuje dostęp do obrazu jako osoby, która wysłała żądanie. Jeśli ustawienia udostępniania arkusza kalkulacyjnego się zmienią, możesz utracić dostęp do obrazu. Zwrócony adres URL wygasa po krótkim czasie.

Zwróć

String – hostowany przez Google URL obrazu.


getUrl()

Pobiera źródłowy adres URL obrazu; zwraca null, jeśli adres URL jest niedostępny. Jeśli obraz został wstawiony przez URL za pomocą interfejsu API, ta metoda zwróci URL podany podczas wstawiania obrazu.

Zwróć

String – adres URL obrazu (jeśli jest dostępny) lub null, jeśli obraz jest niedostępny lub nie ma źródłowego adresu URL.

Autoryzacja

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

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

toBuilder()

Tworzy konstruktor, który zmienia obraz w typ wartości obrazu, dzięki czemu możesz umieścić go w komórce. Zanim obraz zostanie umieszczony w komórce, musi zostać utworzony jako typ wartości obrazu. Następnie możesz dodać go do komórki za pomocą funkcji Range.setValue(value) lub Range.setValues(values).

Zwróć

CellImageBuilder – narzędzie do tworzenia typów wartości obrazów na podstawie podanych właściwości obrazu.