Shape

JSSDK: 1.3.1、FilezOffice V6.0 FP1 支持

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

属性

Height

JSSDK: 1.11.1、FilezOffice V8.3 FP1 支持

返回或设置指定形状对象的高度。可读写 number 类型。

语法

Shape.Height

返回值

Promise<number>

示例

async function example() {
  const shape = await Application.ActiveDocument.Shapes.item(1);
  const height = await shape.Height;
  console.log(height);
  shape.Height = height + 10;
}

name

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

语法

Shape.name

返回值

Promise<string>

示例

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

Width

JSSDK: 1.11.1、FilezOffice V8.3 FP1 支持

返回或设置指定形状对象的宽度。可读写 number 类型。

语法

Shape.Width

返回值

Promise<number>

示例

async function example() {
  const shape = await Application.ActiveDocument.Shapes.item(1);
  const width = await shape.Width;
  console.log(width);
  shape.Width = width + 10;
}

方法

getSize

JSSDK: 1.11.1、FilezOffice V8.3 FP1 支持

一次性获取指定形状对象的宽度和高度。

语法

Shape.getSize()

返回值

Promise<{width: number, height: number}>

示例

async function example() {
  const shape = await Application.ActiveDocument.Shapes.item(1);
  const size = await shape.getSize();
  console.log(size); // {width: 33, height: 154.5}
}

setSize

JSSDK: 1.11.1、FilezOffice V8.3 FP1 支持

一次性设置指定形状对象的宽度和高度。

语法

Shape.setSize(width, height)

参数

属性	数据类型	必填	说明
width	number	是	宽度
height	number	是	高度

返回值

Promise<void>

示例

async function example() {
  const shape = await Application.ActiveDocument.Shapes.item(1);
  const size = await shape.getSize();
  
  // setSize 第一个参数是宽、第二个是高
  await shape.setSize(size.width + 5, size.height + 10);
}

setName

JSSDK: 1.4.0、FilezOffice 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、FilezOffice V6.1 支持

定位浮动图片

语法

Shape.focus()

Shape：浮动图片对象

返回值

Promise<boolean> 是否定位成功

示例

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