全部产品

图形

图形对象

文档中的所有形状对象集合。

语法:

表达式.ActiveDocument.Shapes

表达式:文档类型应用对象

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 图形对象
  const shapes = await app.ActiveDocument.Shapes;
}

插入图片

插入非嵌入式图片。

语法:

表达式.ActiveDocument.Shapes.AddPicture({ FileName, LinkToFile, SaveWithDocument, Left, Top, Width, Height })

表达式:文档类型应用对象

参数:

属性

数据类型

必填

说明

FileName

String

图片的路径和文件名

LinkToFile

Boolean

为 true 表示要将图片链接到创建它的文件,false 使图片文件的独立副本。默认值为 false

SaveWithDocument

Boolean

为 true 要随文档一起保存的链接的图片。默认值为 false

Left

Number

新图片的左边缘相对于绘图画布的位置,以磅为单位

Top

Number

新图片的上边缘相对于绘图画布的位置,以磅为单位

Width

Number

图片的宽度,以磅为单位

Height

Number

图片的高度,以磅为单位

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 获取图形对象
  const shapes = await app.ActiveDocument.Shapes;

  // 插入非嵌入式图片
  await shapes.AddPicture({
    FileName: 'https://xxx.com/a.jpg', // 图片地址
    LinkToFile: true,
    SaveWithDocument: true,
    Left: 10, // 图片距离左边位置
    Top: 10, // 图片距离顶部位置
    Width: 60, // 图片宽度
    Height: 120, // 图片高度
  });
}

图形个数

形状对象的个数。

语法:

表达式.ActiveDocument.Shapes.Count

表达式:文档类型应用对象

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 获取图形对象
  const shapes = await app.ActiveDocument.Shapes;

  // 插入非嵌入式图片
  await shapes.AddPicture({
    FileName: 'https://xxx.com/a.jpg', // 图片地址
    LinkToFile: true,
    SaveWithDocument: true,
    Left: 10, // 图片距离左边位置
    Top: 10, // 图片距离顶部位置
    Width: 60, // 图片宽度
    Height: 120, // 图片高度
  });

  // 获取所有图形数量
  const count = await shapes.Count;
  console.log(count);
}

单个图形

单个图形对象

形状对象集合的单个对象。

语法:

表达式.ActiveDocument.Shapes.Item(Index)

表达式:文档类型应用对象

参数:

属性

数据类型

必填

说明

Index

String

第 Index 个图形

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 获取图形对象
  const shapes = await app.ActiveDocument.Shapes;

  // 插入非嵌入式图片
  await shapes.AddPicture({
    FileName: 'https://xxx.com/a.jpg', // 图片地址
    LinkToFile: true,
    SaveWithDocument: true,
    Left: 10, // 图片距离左边位置
    Top: 10, // 图片距离顶部位置
    Width: 60, // 图片宽度
    Height: 120, // 图片高度
  });

  // 获取第 1 个图形对象
  const shape = await shapes.Item(1);
}

图形宽度

单个图形对象的宽度。

语法:

表达式.ActiveDocument.Shapes.Item(Index).Width

表达式:文档类型应用对象

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 获取图形对象
  const shapes = await app.ActiveDocument.Shapes;

  // 插入非嵌入式图片
  await shapes.AddPicture({
    FileName: 'https://xxx.com/a.jpg', // 图片地址
    LinkToFile: true,
    SaveWithDocument: true,
    Left: 10, // 图片距离左边位置
    Top: 10, // 图片距离顶部位置
    Width: 60, // 图片宽度
    Height: 120, // 图片高度
  });

  // 获取第 1 个图形对象
  const shape = await shapes.Item(1);

  // 设置第 1 个图形的宽度
  shape.Width = 200;
}

图形高度

单个图形对象的高度。

语法:

表达式.ActiveDocument.Shapes.Item(Index).Height

表达式:文档类型应用对象

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 获取图形对象
  const shapes = await app.ActiveDocument.Shapes;

  // 插入非嵌入式图片
  await shapes.AddPicture({
    FileName: 'https://xxx.com/a.jpg', // 图片地址
    LinkToFile: true,
    SaveWithDocument: true,
    Left: 10, // 图片距离左边位置
    Top: 10, // 图片距离顶部位置
    Width: 60, // 图片宽度
    Height: 120, // 图片高度
  });

  // 获取第 1 个图形对象
  const shape = await shapes.Item(1);

  // 设置第 1 个图形的高度
  shape.Height = 240;
}

删除图形

删除单个图形。

语法:

表达式.ActiveDocument.Shapes.Item(Index).Delete()

表达式:文档类型应用对象

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 获取图形对象
  const shapes = await app.ActiveDocument.Shapes;

  // 插入非嵌入式图片
  await shapes.AddPicture({
    FileName: 'https://xxx.com/a.jpg', // 图片地址
    LinkToFile: true,
    SaveWithDocument: true,
    Left: 10, // 图片距离左边位置
    Top: 10, // 图片距离顶部位置
    Width: 60, // 图片宽度
    Height: 120, // 图片高度
  });

  // 获取第 1 个图形对象
  const shape = await shapes.Item(1);

  // 删除单个图形
  await shape.Delete();
}

转换成嵌入式图形

非嵌入式对象转换成嵌入式对象。

语法:

表达式.ActiveDocument.Shapes.Item(Index).ConvertToInlineShape()

表达式:文档类型应用对象

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 获取图形对象
  const shapes = await app.ActiveDocument.Shapes;

  // 插入非嵌入式图片
  await shapes.AddPicture({
    FileName: 'https://xxx.com/a.jpg', // 图片地址
    LinkToFile: true,
    SaveWithDocument: true,
    Left: 10, // 图片距离左边位置
    Top: 10, // 图片距离顶部位置
    Width: 60, // 图片宽度
    Height: 120, // 图片高度
  });

  // 获取第 1 个图形对象
  const shape = await shapes.Item(1);

  // 将第 1 个图形对象转换成嵌入式对象
  await shape.ConvertToInlineShape();
}

设置图形距左值

将指定形状水平移动指定的磅数。

语法:

表达式.ActiveDocument.Shapes.Item(Index).IncrementLeft(Increment)

表达式:文档类型应用对象

参数:

属性

数据类型

必填

说明

Increment

Number

指定形状水平移动的距离,以磅为单位。为正值时将形状右移;为负值时将形状左移

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 获取图形对象
  const shapes = await app.ActiveDocument.Shapes;

  // 插入非嵌入式图片
  await shapes.AddPicture({
    FileName: 'https://xxx.com/a.jpg', // 图片地址
    LinkToFile: true,
    SaveWithDocument: true,
    Left: 10, // 图片距离左边位置
    Top: 10, // 图片距离顶部位置
    Width: 60, // 图片宽度
    Height: 120, // 图片高度
  });

  // 获取第 1 个图形对象
  const shape = await shapes.Item(1);

  // 将第 1 个图形往右移动 30 磅
  await shape.IncrementLeft(30);
}

设置图形距上值

将指定形状水平移动指定的磅数。

语法:

表达式.ActiveDocument.Shapes.Item(Index).IncrementTop(Increment)

表达式:文档类型应用对象

参数:

属性

数据类型

必填

说明

Increment

Number

指定形状水平移动的距离,以磅为单位。为正值时将形状右移;为负值时将形状左移

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 获取图形对象
  const shapes = await app.ActiveDocument.Shapes;

  // 插入非嵌入式图片
  await shapes.AddPicture({
    FileName: 'https://xxx.com/a.jpg', // 图片地址
    LinkToFile: true,
    SaveWithDocument: true,
    Left: 10, // 图片距离左边位置
    Top: 10, // 图片距离顶部位置
    Width: 60, // 图片宽度
    Height: 120, // 图片高度
  });

  // 获取第 1 个图形对象
  const shape = await shapes.Item(1);

  // 将第 1 个图形往下移动 30 磅
  await shape.IncrementTop(30);
}

嵌入式图形

嵌入式图形对象

所选内容中的所有嵌入式对象。

语法:

表达式.ActiveDocument.InlineShapes

表达式:文档类型应用对象

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 所选内容中的所有嵌入式对象
  const info = await app.ActiveDocument.InlineShapes;
}

插入嵌入式图形

语法:

表达式.ActiveDocument.InlineShapes.AddPicture({ FileName, LinkToFile, SaveWithDocument, Range })

表达式:文档类型应用对象

参数:

属性

数据类型

必填

说明

FileName

String

图片的路径和文件名

LinkToFile

String

为 true 表示要将图片链接到创建它的文件,false 使图片文件的独立副本。默认值为 false

SaveWithDocument

String

为 true 要随文档一起保存的链接的图片。默认值为 false

Range

String

图片置于文本中的位置

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 获取图形对象
  const shapes = await app.ActiveDocument.InlineShapes;

  // 插入嵌入式图片
  await shapes.AddPicture({
    FileName: 'https://xxx.com/a.jpg', // 图片路径
    LinkToFile: false,
    SaveWithDocument: false,
    // Range: 图形对象
  });
}

嵌入式图形个数

嵌入式对象的个数。

语法:

表达式.ActiveDocument.InlineShapes.Count

表达式:文档类型应用对象

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 获取图形对象
  const shapes = await app.ActiveDocument.InlineShapes;

  // 插入嵌入式图片
  await shapes.AddPicture({
    FileName: 'https://xxx.com/a.jpg', // 
    LinkToFile: false,
    SaveWithDocument: false,
  });

  // 嵌入式对象的个数
  const count = await shapes.Count;
  console.log(count);
}

单个嵌入式图形

单个嵌入式图形对象

语法:

表达式.ActiveDocument.InlineShapes.Item(Index)

表达式:文档类型应用对象

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 获取图形对象
  const shapes = await app.ActiveDocument.InlineShapes;

  // 插入嵌入式图片
  await shapes.AddPicture({
    FileName: 'https://xxx.com/a.jpg', // 图片路径
    LinkToFile: false,
    SaveWithDocument: false,
  });

  // 获取第 1 个嵌入式图形对象
  const shape = await shapes.Item(1);
}

嵌入式图形宽度

单个嵌入式图形对象的宽度。

语法:

表达式.ActiveDocument.InlineShapes.Item(Index).Width

表达式:文档类型应用对象

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 获取图形对象
  const shapes = await app.ActiveDocument.InlineShapes;

  // 插入嵌入式图片
  await shapes.AddPicture({
    FileName: 'https://xxx.com/a.jpg', // 图片路径
    LinkToFile: false,
    SaveWithDocument: false,
  });

  // 获取第 1 个嵌入式图形对象
  const shape = await shapes.Item(1);

  // 设置嵌入式图形对象的宽度
  shape.Width = 200;
}

嵌入式图形高度

单个嵌入式图形对象的高度。

语法:

表达式.ActiveDocument.InlineShapes.Item(Index).Height

表达式:文档类型应用对象

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 获取图形对象
  const shapes = await app.ActiveDocument.InlineShapes;

  // 插入嵌入式图片
  await shapes.AddPicture({
    FileName: 'https://xxx.com/a.jpg', // 图片路径
    LinkToFile: false,
    SaveWithDocument: false,
  });

  // 获取第 1 个嵌入式图形对象
  const shape = await shapes.Item(1);

  // 设置嵌入式图形对象的高度
  shape.Height = 200;
}

删除嵌入式图形

删除嵌入式图形对象。

语法:

表达式.ActiveDocument.InlineShapes.Item(Index).Delete()

表达式:文档类型应用对象

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 获取图形对象
  const shapes = await app.ActiveDocument.InlineShapes;

  // 插入嵌入式图片
  await shapes.AddPicture({
    FileName: 'https://xxx.com/a.jpg', // 图片路径
    LinkToFile: false,
    SaveWithDocument: false,
  });

  // 获取第 1 个嵌入式图形对象
  const shape = await shapes.Item(1);

  // 删除嵌入式图形对象
  await shape.Delete();
}

转换成非嵌入式图形对象

嵌入式图形对象转换为非嵌入式图形对象。

语法:

表达式.ActiveDocument.InlineShapes.Item(Index).ConvertToShape()

表达式:文档类型应用对象

示例:

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 获取图形对象
  const shapes = await app.ActiveDocument.InlineShapes;

  // 插入嵌入式图片
  await shapes.AddPicture({
    FileName: 'https://xxx.com/a.jpg', // 图片路径
    LinkToFile: false,
    SaveWithDocument: false,
  });

  // 获取第 1 个嵌入式图形对象
  const shape = await shapes.Item(1);

  // 嵌入式图形对象转换为非嵌入式图形对象
  await shape.ConvertToShape();
}