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śćTypOpis
valueTypeValueTypeTyp wartości obrazu komórki, który jest ValueType.IMAGE.

Metody

MetodaZwracany typKrótki opis
getAltTextDescription()StringZwraca tekst alternatywny dla tego obrazu.
getAltTextTitle()StringZwraca tytuł tekstu alternatywnego dla tego obrazu.
getContentUrl()StringZwraca adres URL obrazu hostowanego przez Google.
toBuilder()CellImageBuilderTworzy kreator obrazów komórki na podstawie bieżących właściwości 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