WPS 加载项开发 > 表格 API 参考 > Shapes > 方法 > Shapes.BuildFreeform 方法
建立一个任意多边形对象。返回一个 FreeformBuilder 对象,该对象代表正在创建的任意多边形。用 AddNodes 方法向任意多边形添加线段。如果任意多边形中已包含了一个以上的线段,则可用 ConvertToShape 方法将 FreeformBuilder 对象转换为 Shape 对象,该对象将具有在 FreeformBuilder 对象中定义的几何属性。

语法

表达式.BuildFreeform(EditingType, X1, Y1)

表达式   一个代表 Shapes 对象的变量。

参数

名称 必选/可选 数据类型 说明
EditingType 必选 MsoEditingType 第一个节点的编辑属性。
X1 必选 Single 任意图形中第一个节点相对于文档左上角的位置(以磅为单位)。
Y1 必选 Single 任意图形中第一个节点相对于文档左上角的位置(以磅为单位)。

返回值
FreeformBuilder

示例

本示例将一个有五个顶点的任意多边形添加到 myDocument 中。

示例代码
let myDocument = Worksheets.Item(1)
let bui = myDocument.Shapes.BuildFreeform(msoEditingCorner, 360, 200)
bui.AddNodes(msoSegmentCurve, msoEditingCorner, 380, 230, 400, 250, 450, 300)
bui.AddNodes(msoSegmentCurve, msoEditingAuto, 480, 200)
bui.AddNodes(msoSegmentLine, msoEditingAuto, 480, 400)
bui.AddNodes(msoSegmentLine, msoEditingAuto, 360, 200)
bui.ConvertToShape()


请参阅