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