Продукты Р7
Корпоративный сервер 2024
Корпоративный сервер 2024
Сервер документов
Сервер документов
Редакторы
Редакторы
Корпоративный сервер 2019
Корпоративный сервер 2019
Графика
Графика
Команда
Команда
Мобильные редакторы
Мобильные редакторы
Облачный офис
Облачный офис
Почта
Почта
Органайзер
Органайзер
Дополнительно
Часто задаваемые вопросы
Разработчикам
Интеграции
Новые возможности

AddShape

Обновлено: 15.12.25

AddShape([sType], nWidth, nHeight, oFill, oStroke, nFromCol, nColOffset, nFromRow, nRowOffset) → { ApiShape }

Добавляет фигуру на текущий лист с указанными параметрами. Обратите внимание, что смещения по горизонтали и вертикали рассчитываются только в пределах указанных ячеек столбца и строки. Если это значение превышает ширину или высоту ячейки, будет установлено другое вертикальное/горизонтальное положение.

Параметры:

Название Тип По умолчанию Описание
sType ShapeType «rect» Тип формы, определяющий предустановленную геометрию формы.
nWidth EMU Ширина фигуры в английских единицах измерения.
nHeight EMU Высота фигуры в английских единицах измерения.
oFill ApiFill Цвет или узор, используемый для заполнения формы.
oStroke ApiStroke Штрих, используемый для создания тени элемента.
nFromCol численный Номер столбца, в котором будет размещено начало фигуры.
nColOffset EMU Смещение от столбца nFromCol до левой части фигуры, измеренное в английских единицах измерения.
nFromRow численный Номер строки, в которой будет размещено начало фигуры.
nRowOffset EMU Смещение от строки nFromRow до верхней части фигуры, измеренное в английских единицах измерения.

Возвраащет:

Тип ApiShape

Пример

builder.CreateFile("xlsx");
var oWorksheet = Api.GetActiveSheet();
var oGs1 = Api.CreateGradientStop(Api.CreateRGBColor(255, 213, 191), 0);
var oGs2 = Api.CreateGradientStop(Api.CreateRGBColor(255, 111, 61), 100000);
var oFill = Api.CreateLinearGradientFill([oGs1, oGs2], 5400000);
var oStroke = Api.CreateStroke(0, Api.CreateNoFill());
oWorksheet.AddShape("flowChartOnlineStorage", 60 * 36000, 35 * 36000, oFill, oStroke, 0, 2 * 36000, 0, 3 * 36000);
builder.SaveFile("xlsx", "AddShape.xlsx");
builder.CloseFile();