Shape

Shape

JSSDK: 1.3.1、zOffice V6.0 FP1 支持

代表绘图层中的对象，例如自选图形、任意多边形、OLE 对象、ActiveX 控件或图片。 Shape 对象是 Shapes 集合的成员，该集合包括文档主文章的所有形状。（目前仅支持浮动图片）

属性

name

返回指定形状对象的名称。 只读 String 类型。

语法

Shape.name

返回值

Promise<string>

示例

async function example() {
  const shape = await Application.ActiveDocument.Shapes.item(1);
  const name = await shape.name;
}

方法

setName

JSSDK: 1.4.0、zOffice V6.1 支持

设置指定形状对象的名称。

语法

Shape.setName(name)

参数

属性	数据类型	必填	说明
name	string	是	形状对象的名称

返回值

Promise<boolean>

示例

async function example() {
  const shape = await Application.ActiveDocument.Shapes.item(1);
  const success = await shape.setName("浮动签章");
}

delete

删除指定的图形节点。

语法

Shape.delete()

返回值

Promise<boolean>

示例

async function example() {
  const shape = await Application.ActiveDocument.Shapes.item(1);
  const success = await shape.delete();
}

focus

JSSDK: 1.4.0、zOffice V6.1 支持

定位浮动图片

语法

Shape.focus()

Shape：浮动图片对象

返回值

Promise<boolean> 是否定位成功

示例

async function example() {
 const shape = await Application.ActiveDocument.Shapes.item(1);
 const success = await shape.focus();
}