Class Drawing

Рисунок

Отображает рисунок на листе в электронной таблице.

Методы

Метод Тип возвращаемого значения Краткое описание
get Container Info() Container Info Получает информацию о местоположении рисунка на листе.
get Height() Integer Возвращает фактическую высоту этого рисунка в пикселях.
get On Action() String|null Возвращает имя макроса, прикрепленного к этому чертежу.
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|null — Имя макроса, присвоенное этому рисунку.

Авторизация

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

  • 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)

Задает положение рисунка на листе. Индексы позиций в якорной строке и столбце начинаются с единицы.

Параметры

Имя Тип Описание
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 — Этот рисунок предназначен для создания цепочки.