Class Drawing

Рисунок

Представляет рисунок поверх листа электронной таблицы.

Методы

Метод Тип возврата Краткое описание
get Container Info() Container Info Получает информацию о расположении рисунка на листе.
get Height() Integer Возвращает фактическую высоту этого рисунка в пикселях.
get On Action() String Возвращает имя макроса, прикрепленного к этому рисунку.
get Sheet() Sheet Возвращает лист, на котором находится этот рисунок.
get Width() Integer Возвращает фактическую ширину этого рисунка в пикселях.
get ZIndex() Number Возвращает z-индекс этого рисунка.
remove() void Удаляет этот рисунок из электронной таблицы.
set Height(height) Drawing Устанавливает фактическую высоту этого рисунка в пикселях.
set On Action(macroName) Drawing Назначает макрофункцию этому рисунку.
set Position(anchorRowPos, anchorColPos, offsetX, offsetY) Drawing Устанавливает положение рисунка на листе.
set Width(width) Drawing Устанавливает фактическую ширину этого рисунка в пикселях.
set ZIndex(zIndex) Drawing Устанавливает z-индекс этого рисунка.

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

get Container Info()

Получает информацию о расположении рисунка на листе.

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

Container Info — объект, содержащий позицию контейнера чертежа.

Авторизация

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

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

get Height()

Возвращает фактическую высоту этого рисунка в пикселях.

// Logs the height of all drawings in a sheet
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getHeight());
}

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

Integer — Высота рисунка в пикселях.

Авторизация

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

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

get On Action()

Возвращает имя макроса, прикрепленного к этому рисунку.

// Logs the macro name of all drawings on the active sheet.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getOnAction());
}

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

String — имя макроса, прикрепленное к этому рисунку.

Авторизация

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

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

get Sheet()

Возвращает лист, на котором находится этот рисунок.

// Logs the parent sheet of all drawings on the active sheet.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getSheet());
}

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

Sheet — лист, на котором отображается рисунок.

Авторизация

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

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

get Width()

Возвращает фактическую ширину этого рисунка в пикселях.

// Logs the width of all drawings in a sheet
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getWidth());
}

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

Integer — ширина рисунка в пикселях.

Авторизация

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

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

get ZIndex()

Возвращает z-индекс этого рисунка.

// Logs the z-index of all drawings on the active sheet.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getZIndex());
}

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

Number — Z-индекс этого рисунка.

Авторизация

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

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

remove()

Удаляет этот рисунок из электронной таблицы. Любая дальнейшая операция с рисунком приводит к ошибке сценария.

// Deletes all drawings from the active sheet.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  drawings[i].remove();
}

Авторизация

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

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

set Height(height)

Устанавливает фактическую высоту этого рисунка в пикселях.

Параметры

Имя Тип Описание
height Integer Желаемая высота в пикселях.

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

Drawing — Этот рисунок для цепочки.

Авторизация

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

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

set On Action(macroName)

Назначает макрофункцию этому рисунку.

Параметры

Имя Тип Описание
macro Name String Имя макрофункции.

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

Drawing — Этот рисунок для цепочки.

set Position(anchorRowPos, anchorColPos, offsetX, offsetY)

Устанавливает положение рисунка на листе. Индексы позиции привязки строки и столбца имеют индекс 1.

Параметры

Имя Тип Описание
anchor Row Pos Integer Верхняя сторона рисунка закреплена в этой строке.
anchor Col Pos Integer Верхняя сторона рисунка закреплена в этом столбце.
offsetX Integer Горизонтальное смещение от угла ячейки в пикселях.
offsetY Integer Вертикальное смещение от угла ячейки в пикселях.

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

Drawing — Этот рисунок для цепочки.

Авторизация

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

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

set Width(width)

Устанавливает фактическую ширину этого рисунка в пикселях.

Параметры

Имя Тип Описание
width Integer Желаемая ширина в пикселях.

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

Drawing — Этот рисунок для цепочки.

Авторизация

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

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

set ZIndex(zIndex)

Устанавливает z-индекс этого рисунка.

Параметры

Имя Тип Описание
zIndex Number Z-индекс этого рисунка.

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

Drawing — Этот рисунок для цепочки.