AddShape([sType], nWidth, nHeight, oFill, oStroke, nFromCol, nColOffset, nFromRow, nRowOffset) → { ApiShape }
Добавляет фигуру на текущий лист с указанными параметрами.
Важно
Смещения по горизонтали и вертикали рассчитываются только в пределах указанных ячеек столбца и строки. Если это значение превышает ширину или высоту ячейки, будет установлено другое вертикальное/горизонтальное положение.
Параметры
| Название | Тип | По умолчанию | Описание |
|---|---|---|---|
sType | ShapeType | "rect" | Тип формы, определяющий предустановленную геометрию формы. |
nWidth | EMU | Ширина фигуры в английских единицах измерения. | |
nHeight | EMU | Высота фигуры в английских единицах измерения. | |
oFill | ApiFill | Цвет или узор, используемый для заполнения формы. | |
oStroke | ApiStroke | Штрих, используемый для создания тени элемента. | |
nFromCol | number | Номер столбца, в котором будет размещено начало фигуры. | |
nColOffset | EMU | Смещение от столбца nFromCol до левой части фигуры, измеренное в английских единицах измерения. | |
nFromRow | number | Номер строки, в которой будет размещено начало фигуры. | |
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();
