• Post category:ApiWorksheet
  • Запись изменена:21.04.2023

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

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

Параметры:

НазваниеТипПо умолчаниюОписание
sTypeShapeType«rect»Тип формы, определяющий предустановленную геометрию формы.
nWidthEMUШирина фигуры в английских единицах измерения.
nHeightEMUВысота фигуры в английских единицах измерения.
oFillApiFillЦвет или узор, используемый для заполнения формы.
oStrokeApiStrokeШтрих, используемый для создания тени элемента.
nFromColчисленныйНомер столбца, в котором будет размещено начало фигуры.
nColOffsetEMUСмещение от столбца nFromCol до левой части фигуры, измеренное в английских единицах измерения.
nFromRowчисленныйНомер строки, в которой будет размещено начало фигуры.
nRowOffsetEMUСмещение от строки 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();