Эта страница переведена с помощью Cloud Translation API.

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