Class CellImage

CellImage

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

Właściwości

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

Metody

MetodaZwracany typKrótki opis
getAltTextDescription()StringZwraca tekst alternatywny tego obrazu.
getAltTextTitle()StringZwraca tytuł tekstu alternatywnego tego obrazu.
getContentUrl()StringZwraca adres URL obrazu hostowanego w Google.
toBuilder()CellImageBuilderTworzy narzędzie do tworzenia obrazów komórek na podstawie bieżących właściwości obrazu.

Szczegółowa dokumentacja

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.

toBuilder()

Tworzy narzędzie do tworzenia obrazów komórek na podstawie bieżących właściwości obrazu. Użyj kodu CellImageBuilder.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