AddShape

使用指定的参数向当前工作表添加形状。

备注

水平和垂直偏移量仅在指定列和行单元格的范围内计算。如果此值超过单元格宽度或高度，将设置其他垂直/水平位置。

语法

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

expression - 表示 ApiWorksheet 类的变量。

参数

名称	必需/可选	数据类型	默认值	描述
sType	可选	ShapeType	"rect"	指定预设形状几何图形的形状类型。"textRect" 类型会以编辑器插入文本框的方式创建文本框：浅色填充和黑色细轮廓。
nWidth	必需	EMU		以英制度量单位表示的形状宽度。
nHeight	必需	EMU		以英制度量单位表示的形状高度。
oFill	可选	ApiFill		用于填充形状的颜色或图案。如果未指定，则使用默认形状样式填充（主题强调色）。
oStroke	可选	ApiStroke		用于绘制形状轮廓的笔触。如果未指定，则使用默认形状样式轮廓（主题强调色）。
nFromCol	必需	number		形状起始位置所在的列号。
nColOffset	必需	EMU		从 nFromCol 列到形状左侧的偏移量，以英制单位测量。
nFromRow	必需	number		形状起始位置所在的行号。
nRowOffset	必需	EMU		从 nFromRow 行到形状上部的偏移量，以英制单位测量。

返回值

ApiShape | null

示例

在电子表格的工作表上绘制具有自定义填充和位置的形状。

// How do I place a colored geometric shape onto a worksheet in a spreadsheet?

// Decorate a sheet by adding a gradient-filled shape at defined coordinates.

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);