修订(Revisions)

Revision 对象的集合

属性列表

属性	说明
Count	获取修订个数
Mode	修订开关状态

方法列表

方法	返回类型	说明
SwitchMode()	无	切换修订开关状态
AcceptAll()	无	接受所有修订
RejectAll()	无	拒绝所有修订
Item()	Revision	单个修订对象

Count

获取修订个数

语法

表达式.ActiveDocument.Revisions.Count

返回值

返回 Number 代表文档内容控件的数量。

示例

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

  const app = jssdk.Application;

  // 获取修订数量
  const count = await app.ActiveDocument.Revisions.Count;
  console.log(count);
}

Mode

获取修订开关状态

语法

表达式.ActiveDocument.Revisions.Mode

返回值

返回 Boolean 代表文档是否开启了修订。

示例

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

  const app = jssdk.Application;

  // 获取修订状态
  const mode = await app.ActiveDocument.Revisions.Mode;
  console.log(mode);
}

SwitchMode()

接受对指定文档的所有修订

语法

表达式.ActiveDocument.Revisions.SwitchMode(mode: Boolean)

参数

属性	类型	默认值	必填	说明
mode	Boolean		是	true 为开启，false 为关闭。

示例

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

  const app = jssdk.Application;

  // 打开修订状态
  await app.ActiveDocument.Revisions.SwitchMode(true);
}

AcceptAll()

接受对指定文档的所有修订

语法

表达式.ActiveDocument.Revisions.AcceptAll()

示例

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

  const app = jssdk.Application;

  // 接受所有修订
  await app.ActiveDocument.Revisions.AcceptAll();
}

RejectAll()

拒绝对指定文档的所有修订

语法

表达式.ActiveDocument.Revisions.RejectAll()

示例

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

  const app = jssdk.Application;

  // 接受所有修订
  await app.ActiveDocument.Revisions.RejectAll();
}

Item()

书签集合的单个修订对象

语法

表达式.ActiveDocument.Revisions.Item(index: Number)

参数

属性	类型	默认值	必填	说明
index	Number		是	修订的序号

返回值

返回 Revision 对象，拥有以下属性和方法

属性列表

属性	类型	说明
Author	String	修订作者
Date	timestamp	时间戳
Type	Number	修订类型，枚举值如下：

方法列表

属性	说明
Accept()	接受当前修订
Reject()	拒绝当前修订

示例

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

  const app = jssdk.Application;

  const firstRevision = await app.ActiveDocument.Revisions.Item(1);

  console.log(await firstRevision.Author); // 修订的作者
  console.log(await firstRevision.Date); // 修订的时间戳
  console.log(await firstRevision.Type); // 修订类型
  await firstRevision.Accept(); // 接受单个修订
}

IMPORTANT

请勿在循环体内使用动态索引对单个修订进行 Accept() 或 Reject()，因为索引会实时变化，这会导致错误的结果