Class Drawing

Рисунок

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

Методы

Метод Тип возврата Краткое описание
getContainerInfo() ContainerInfo Получает информацию о расположении рисунка на листе.
getHeight() Integer Возвращает фактическую высоту этого рисунка в пикселях.
getOnAction() String Возвращает имя макроса, прикрепленного к этому рисунку.
getSheet() Sheet Возвращает лист, на котором находится этот рисунок.
getWidth() Integer Возвращает фактическую ширину этого рисунка в пикселях.
getZIndex() Number Возвращает z-индекс этого рисунка.
remove() void Удаляет этот рисунок из электронной таблицы.
setHeight(height) Drawing Устанавливает фактическую высоту этого рисунка в пикселях.
setOnAction(macroName) Drawing Назначает макрофункцию этому рисунку.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY) Drawing Устанавливает положение рисунка на листе.
setWidth(width) Drawing Устанавливает фактическую ширину этого рисунка в пикселях.
setZIndex(zIndex) Drawing Устанавливает z-индекс этого рисунка.

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

getContainerInfo()

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

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

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

Авторизация

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

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

getHeight()

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

// Logs the height of all drawings in a sheet
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var 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

getOnAction()

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

// Logs the macro name of all drawings on the active sheet.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var 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

getSheet()

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

// Logs the parent sheet of all drawings on the active sheet.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var 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

getWidth()

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

// Logs the width of all drawings in a sheet
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var 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

getZIndex()

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

// Logs the z-index of all drawings on the active sheet.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var 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.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
  drawings[i].remove();
}

Авторизация

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

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

setHeight(height)

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

Параметры

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

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

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

Авторизация

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

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

setOnAction(macroName)

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

Параметры

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

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

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

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

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

Параметры

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

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

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

Авторизация

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

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

setWidth(width)

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

Параметры

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

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

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

Авторизация

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

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

setZIndex(zIndex)

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

Параметры

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

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

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