Class CellImageBuilder

Построитель изображений ячеек

Построитель Cell Image . Этот построитель создает значение изображения, необходимое для добавления изображения в ячейку.

Характеристики

Свойство Тип Описание
value Type Value Type Тип значения изображения ячейки — Value Type.IMAGE .

Методы

Метод Тип возврата Краткое описание
build() Cell Image Создает тип значения изображения, необходимый для добавления изображения в ячейку.
get Alt Text Description() String Возвращает альтернативное текстовое описание для этого изображения.
get Alt Text Title() String Возвращает замещающий текстовый заголовок для этого изображения.
get Content Url() String Возвращает URL-адрес изображения, размещенный в Google.
set Alt Text Description(description) Cell Image Устанавливает альтернативное текстовое описание для этого изображения.
set Alt Text Title(title) Cell Image Устанавливает замещающий текстовый заголовок для этого изображения.
set Source Url(url) Cell Image Builder Устанавливает URL-адрес источника изображения.
to Builder() Cell Image Builder Создает построитель изображений ячеек на основе текущих свойств изображения.

Подробная документация

build()

Создает тип значения изображения, необходимый для добавления изображения в ячейку. Значение изображения создается на основе свойств изображения, добавленных в конструктор, таких как исходный URL-адрес.

Возвращаться

Cell Image — представление изображения, добавляемого в ячейку.

get Alt Text Description()

Возвращает альтернативное текстовое описание для этого изображения.

Возвращаться

String — описание альтернативного текста.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

get Alt Text Title()

Возвращает замещающий текстовый заголовок для этого изображения.

Возвращаться

String — заголовок альтернативного текста.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

get Content Url()

Возвращает URL-адрес изображения, размещенный в Google. Этот URL-адрес помечен учетной записью запрашивающего, поэтому любой, у кого есть URL-адрес, фактически получает доступ к изображению как исходный запрашивающий. Доступ к изображению может быть потерян, если изменяются настройки общего доступа к электронной таблице. Срок действия возвращенного URL-адреса истекает через короткий период времени.

const range = SpreadsheetApp.getActiveSpreadsheet().getRange("Sheet1!A1");
const value = range.getValue();
if (value.valueType == SpreadsheetApp.ValueType.IMAGE) {
  console.log(value.getContentUrl());
}

Возвращаться

String — URL-адрес изображения, размещенный в Google.

set Alt Text Description(description)

Устанавливает альтернативное текстовое описание для этого изображения.

Параметры

Имя Тип Описание
description String Новое альтернативное текстовое описание изображения.

Возвращаться

Cell Image — это изображение для объединения.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

set Alt Text Title(title)

Устанавливает замещающий текстовый заголовок для этого изображения.

Параметры

Имя Тип Описание
title String Новый альтернативный текстовый заголовок для изображения.

Возвращаться

Cell Image — это изображение для объединения.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

set Source Url(url)

Устанавливает URL-адрес источника изображения.

Параметры

Имя Тип Описание
url String URL-адрес изображения.

Возвращаться

Cell Image Builder — этот конструктор для создания цепочек.

to Builder()

Создает построитель изображений ячеек на основе текущих свойств изображения. Используйте set Source Url(url) чтобы установить исходный URL-адрес нового изображения. Затем вы можете добавить его в ячейку, используя Range.setValue(value) или 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);
}

Возвращаться

Cell Image Builder — построитель, который создает тип значения изображения на основе заданных свойств изображения.

Устаревшие методы