跳到主要内容

AddShape

使用指定的参数向当前工作表添加形状。 💡 请注意,水平和垂直偏移量仅在指定列和行单元格的范围内计算。如果此值超过单元格宽度或高度,将设置其他垂直/水平位置。

语法

expression.AddShape(sType, nWidth, nHeight, oFill, oStroke, nFromCol, nColOffset, nFromRow, nRowOffset);

expression - 表示 ApiWorksheet 类的变量。

参数

名称必需/可选数据类型默认值描述
sType可选ShapeType"rect"指定预设形状几何图形的形状类型。
nWidth必需EMU以英制度量单位表示的形状宽度。
nHeight必需EMU以英制度量单位表示的形状高度。
oFill必需ApiFill用于填充形状的颜色或图案。
oStroke必需ApiStroke用于创建元素阴影的笔触。
nFromCol必需number形状起始位置所在的列号。
nColOffset必需EMU从 nFromCol 列到形状左侧的偏移量,以英制单位测量。
nFromRow必需number形状起始位置所在的行号。
nRowOffset必需EMU从 nFromRow 行到形状上部的偏移量,以英制单位测量。

返回值

ApiShape

示例

此示例使用指定的参数向工作表添加形状。

// How to add a shape to the worksheet.

// Insert a flowchart shape to the worksheet.

let worksheet = Api.GetActiveSheet();
let gradientStop1 = Api.CreateGradientStop(Api.RGB(255, 213, 191), 0);
let gradientStop2 = Api.CreateGradientStop(Api.RGB(255, 111, 61), 100000);
let fill = Api.CreateLinearGradientFill([gradientStop1, gradientStop2], 5400000);
let stroke = Api.CreateStroke(0, Api.CreateNoFill());
worksheet.AddShape("flowChartOnlineStorage", 60 * 36000, 35 * 36000, fill, stroke, 0, 2 * 36000, 0, 3 * 36000);