修订

本文介绍使用文字文档时如何获取修订对象、接受文档所有修订、获取单个修订对象的修订时间等。

获取修订对象

获取指定修订对象。

  • 语法

    表达式.ActiveDocument.Revisions

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

  • 示例

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
    
      //获取修订对象
      const revisions = await app.ActiveDocument.Revisions;
    }

切换模式

切换编辑模式与修订模式。

  • 语法

    表达式.ActiveDocument.TrackRevisions = Boolean

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

    Boolean值为true,表示切换到修订模式,Boolean值为false,表示切换到编辑模式。

  • 示例

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
    
      //将当前文档的编辑状态切换成修订模式
      app.ActiveDocument.TrackRevisions = true;
    }

获取全文修订内容

获取全文的修订内容。

  • 语法

    表达式.ActiveDocument.Revisions.Json()

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

  • 返回值

    Array.<Object>的形式返回全部修订内容,例如[{ user, ... }],具体返回内容如下表所示:

    属性

    数据类型

    描述

    user

    String

    用户名。

    leader

    String

    修订批注。

    begin

    String

    修订开始位置。

    end

    String

    修订结束位置。

    content

    String

    修订后内容。

    type

    String

    修订类型。

  • 示例

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
    
      //获取修订对象
      const revisions = await app.ActiveDocument.Revisions;
    
      //获取全文修订内容
      const revisionData = await revisions.Json();
      console.log(revisionData);
    }

获取全文修订数量

获取全文的修订数量。

  • 语法

    表达式.ActiveDocument.Revisions.Count

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

  • 示例

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
    
      //获取修订对象
      const revisions = await app.ActiveDocument.Revisions;
    
      //获取全文修订数量
      const count = await revisions.Count;
      console.log(count);
    }

接受所有修订

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

  • 语法

    表达式.ActiveDocument.Revisions.AcceptAll()

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

  • 示例

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
    
      //获取修订对象
      const revisions = await app.ActiveDocument.Revisions;
      
      //接受对指定文档的所有修订
      await revisions.AcceptAll();
    }

拒绝所有修订

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

  • 语法

    表达式.ActiveDocument.Revisions.RejectAll()

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

  • 示例

    async function example() {
      await instance.ready();
    
      //获取修订对象
      const revisions = await app.ActiveDocument.Revisions;
      
      //拒绝对指定文档的所有修订
      await revisions.RejectAll();
    }

单个修订

获取单个修订对象

  • 语法

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

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

  • 示例

    async function example() {
      await instance.ready();
    
      //获取修订对象
      const revisions = await app.ActiveDocument.Revisions;
      
      //获取单个修订对象
      const revision = await revisions.Item(1);
    }

获取修订时间

  • 语法

    表达式.ActiveDocument.Revisions.Item(Index).Date

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

  • 示例

    async function example() {
      await instance.ready();
    
      //获取修订对象
      const revisions = await app.ActiveDocument.Revisions;
      
      //获取单个修订对象
      const revision = await revisions.Item(1);
    
      //获取修订时间
      const date = await revision.Date;
      console.log(date);
    }

获取修订作者

  • 语法

    表达式.ActiveDocument.Revisions.Item(Index).Author

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

  • 示例

    async function example() {
      await instance.ready();
    
      //获取修订对象
      const revisions = await app.ActiveDocument.Revisions;
      
      //获取单个修订对象
      const revision = await revisions.Item(1);
    
      //获取修订作者
      const author = await revision.Author;
      console.log(author);
    }

获取修订类型

  • 语法

    表达式.ActiveDocument.Revisions.Item(Index).Type

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

  • 返回值

    返回EnumWdRevisionType表示对应修订类型。

    属性

    数据类型

    描述

    WdRevisionType

    Enum

    修订类型。Enum.WdRevisionType取值范围如下:

    • 0或wdNoRevision:无修订。

    • 1或wdRevisionInsert:插入。

    • 2或wdRevisionDelete:删除。

  • 示例

    async function example() {
      await instance.ready();
    
      //获取修订对象
      const revisions = await app.ActiveDocument.Revisions;
      
      //获取单个修订对象
      const revision = await revisions.Item(1);
    
      //获取修订类型
      const type = await revision.Type;
      console.log(type);
    }

获取修订范围

  • 语法

    表达式.ActiveDocument.Revisions.Item(Index).Range

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

  • 示例

    async function example() {
      await instance.ready();
    
      //获取修订对象
      const revisions = await app.ActiveDocument.Revisions;
      
      //获取单个修订对象
      const revision = await revisions.Item(1);
    
      //获取修订范围
      const range = await revision.Range;
      console.log(range);
    }

    获取修订作者ID

  • 语法

    表达式.ActiveDocument.Revisions.Item(Index).userID

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

  • 示例

    async function example() {
      await instance.ready();
    
      // 获取修订对象
      const revisions = await app.ActiveDocument.Revisions;
      
      // 获取单个修订对象
      const revision = await revisions.Item(1);
    
      // 获取修订用户ID
      const userID = await revision.userID;
      console.log(userID);
    }