水印

本文介绍使用文字文档时如何获取水印对象、插入文字水印、删除水印等。

获取水印对象

  • 语法

    表达式.ActiveDocument.Sections.Item(Index).WaterMarks

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

  • 参数

    属性

    数据类型

    是否必填

    描述

    Index

    Number

    Index个代表所选内容、范围或文档中的部分。

  • 示例

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
      
      //水印对象
      const waterMarks = await app.ActiveDocument.Sections.Item(1).WaterMarks;
    }

插入模板水印

  • 语法

    表达式.ActiveDocument.Sections.Item(Index).WaterMarks.AddTemplateWaterMark({ Index, ApplyTo })

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

  • 参数

    属性

    数据类型

    是否必填

    描述

    Index

    Number

    使用预设模板水印的索引。

    ApplyTo

    Number

    插入的位置。取值范围如下:

    • 0:当前节。

    • 1:整个文档。

  • 示例

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
      
      //水印对象
      const waterMarks = await app.ActiveDocument.Sections.Item(1).WaterMarks;
    
      //在整个文档插入第2个预设的模板水印
      waterMarks.AddTemplateWaterMark({
        Index: 2,
        ApplyTo: 1,
      });
    }

插入文字水印

  • 语法

    表达式.ActiveDocument.Sections.Item(Index).WaterMarks.AddTemplateWaterMark({ Text, FontName, FontSize, FontColor, Transparency, Gradient })

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

  • 参数

    属性

    数据类型

    是否必填

    描述

    Text

    String

    水印文本。

    FontName

    String

    水印字体类型。

    FontSize

    Number

    水印字体大小。

    FontColor

    String

    水印字体颜色,默认值为0xC0C0C0。

    Transparency

    Number

    水印透明度。

    Gradient

    Boolean

    水印倾斜度。取值范围如下:

    • false(默认):不倾斜。

    • true:倾斜。

    ApplyTo

    Number

    水印插入位置。默认值为1,即整个文档。

  • 示例

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
      
      //水印对象
      const waterMarks = await app.ActiveDocument.Sections.Item(1).WaterMarks;
    
      //插入文字水印
      await waterMarks.AddTextWaterMark({
        Text: '水印文本', /Text:水印文本
        FontName: '宋体', //FontName:水印字体类型
        FontSize: 40, //FontSize:水印字体大小
        FontColor: '#171717', //FontColor:水印字体颜色
        Transparency: 0.3, //Transparency:透明度
        Gradient: false, //Gradient:倾斜度
        ApplyTo: 1, //ApplyTo:插入位置
      });
    }

编辑水印

  • 语法

    表达式.ActiveDocument.Sections.Item(Index).WaterMarks.EditTextWaterMark({ Text, FontName, FontSize, FontColor, Transparency, Gradient })

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

  • 参数

    属性

    数据类型

    是否必填

    描述

    Text

    String

    水印文本。

    FontName

    String

    水印字体类型。

    FontSize

    Number

    水印字体大小。

    FontColor

    String

    水印字体颜色,默认值为0xC0C0C0。

    Transparency

    Number

    水印透明度。

    Gradient

    Boolean

    水印倾斜度。

    ApplyTo

    Number

    水印插入位置。默认值为1,即整个文档。

  • 示例

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
      
      //水印对象
      const waterMarks = await app.ActiveDocument.Sections.Item(1).WaterMarks;
    
      //编辑水印
      await waterMarks.EditTextWaterMark({
        Text: '', //Text水印文本。
        FontName: '宋体', //FontName水印字体类型
        FontSize: 66, //FontSize:水印字体大小
        FontColor: '#f00', //FontColor:水印字体颜色
        Transparency: 1, //Transparency:透明度
        Gradient: true, //Gradient:倾斜度
        ApplyTo: 1, //ApplyTo:插入位置
      });
    }

删除水印

  • 语法

    表达式.ActiveDocument.Sections.Item(Index).WaterMarks.DeleteWaterMark()

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

  • 示例

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
      
      //水印对象
      const waterMarks = await app.ActiveDocument.Sections.Item(1).WaterMarks;
    
      //删除水印
      waterMarks.DeleteWaterMark();
    }

单个水印

获取单个水印对象

  • 语法

    表达式.ActiveDocument.Sections.Item(Index).WaterMarks.Item(Index)

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

  • 参数

    属性

    数据类型

    是否必填

    描述

    Index

    Number

    Index个水印对象。

  • 示例

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
      
      //水印对象
      const waterMarks = await app.ActiveDocument.Sections.Item(1).WaterMarks;
    
      //单个水印对象
      const waterMark = await waterMarks.Item(1);
    }

设置水印文本

  • 语法

    表达式.ActiveDocument.Sections.Item(Index).WaterMarks.Item(Index).Text

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

  • 示例

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
    
      //插入文字水印
      await app.ActiveDocument.ActiveWindow.Selection.AddTextWaterMark({
        Text: '水印文本', //Text:水印文本
        FontName: '宋体', //FontName:水印字体类型
        FontSize: 40, //FontSize:水印字体大小
        FontColor: '#171717', //FontColor:水印字体颜色
        Transparency: 0.3, //Transparency:透明度
        Gradient: false, //Gradient:倾斜度
        ApplyTo: 1, //ApplyTo:插入位置
      });
    
      //水印对象
      const waterMarks = await app.ActiveDocument.Sections.Item(1).WaterMarks;
    
      //获取水印
      const waterMark = await waterMarks.Item(1);
    
      //设置水印的文本
      waterMark.Text = 'WebOffice';
    }

设置水印字体类型

  • 语法

    表达式.ActiveDocument.Sections.Item(Index).WaterMarks.Item(Index).FontName

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

  • 示例

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
    
      //插入文字水印
      await app.ActiveDocument.ActiveWindow.Selection.AddFontNameWaterMark({
        Text: '水印文本', //FontName:水印文本
        FontName: '宋体', //FontName:水印字体类型
        FontSize: 40, //FontSize:水印字体大小
        FontColor: '#171717', //FontColor:水印字体颜色
        Transparency: 0.3, //Transparency:透明度
        Gradient: false, //Gradient:倾斜度
        ApplyTo: 1, //ApplyTo:插入位置
      });
    
      //水印对象
      const waterMarks = await app.ActiveDocument.Sections.Item(1).WaterMarks;
    
      //获取水印
      const waterMark = await waterMarks.Item(1);
    
      //设置水印的字体类型
      waterMark.FontName = '楷体';
    }

设置水印字体颜色

  • 语法

    表达式.ActiveDocument.Sections.Item(Index).WaterMarks.Item(Index).FontColor

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

  • 示例

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
    
      //插入文字水印
      await app.ActiveDocument.ActiveWindow.Selection.AddFontNameWaterMark({
        Text: '水印文本', //FontName:水印文本
        FontName: '宋体', //FontName:水印字体类型
        FontSize: 40, //FontSize:水印字体大小
        FontColor: '#171717', //FontColor:水印字体颜色
        Transparency: 0.3, //Transparency:透明度
        Gradient: false, //Gradient:倾斜度
        ApplyTo: 1, //ApplyTo:插入位置
      });
    
      //水印对象
      const waterMarks = await app.ActiveDocument.Sections.Item(1).WaterMarks;
    
      //获取水印
      const waterMark = await waterMarks.Item(1);
    
      //设置水印的字体颜色
      waterMark.FontColor = '#fff000';
    }

设置水印字体大小

  • 语法

    表达式.ActiveDocument.Sections.Item(Index).WaterMarks.Item(Index).FontSize

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

  • 示例

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
    
      //插入文字水印
      await app.ActiveDocument.ActiveWindow.Selection.AddFontNameWaterMark({
        Text: '水印文本', //FontName:水印文本
        FontName: '宋体', //FontName:水印字体类型
        FontSize: 40, //FontSize:水印字体大小
        FontColor: '#171717', //FontColor:水印字体颜色
        Transparency: 0.3, //Transparency:透明度
        Gradient: false, //Gradient:倾斜度
        ApplyTo: 1, //ApplyTo:插入位置
      });
    
      //水印对象
      const waterMarks = await app.ActiveDocument.Sections.Item(1).WaterMarks;
    
      //获取水印
      const waterMark = await waterMarks.Item(1);
    
      //设置水印的字体大小
      waterMark.FontSize = 80;
    }

设置水印倾斜度

  • 语法

    表达式.ActiveDocument.Sections.Item(Index).WaterMarks.Item(Index).Gradient

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

  • 示例

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
    
      //插入文字水印
      await app.ActiveDocument.ActiveWindow.Selection.AddFontNameWaterMark({
        Text: '水印文本', //FontName:水印文本
        FontName: '宋体', //FontName:水印字体类型
        FontSize: 40, //FontSize:水印字体大小
        FontColor: '#171717', //FontColor:水印字体颜色
        Transparency: 0.3, //Transparency:透明度
        Gradient: false, //Gradient:倾斜度
        ApplyTo: 1, //ApplyTo:插入位置
      });
    
      //水印对象
      const waterMarks = await app.ActiveDocument.Sections.Item(1).WaterMarks;
    
      //获取水印
      const waterMark = await waterMarks.Item(1);
    
      //设置水印的倾斜度
      waterMark.Gradient = true;
    }

设置水印透明度

  • 语法

    表达式.ActiveDocument.Sections.Item(Index).WaterMarks.Item(Index).Transparency

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

  • 示例

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
    
      //插入文字水印
      await app.ActiveDocument.ActiveWindow.Selection.AddFontNameWaterMark({
        Text: '水印文本', //FontName:水印文本
        FontName: '宋体', //FontName:水印字体类型
        FontSize: 40, //FontSize:水印字体大小
        FontColor: '#171717', //FontColor:水印字体颜色
        Transparency: 0.3, //Transparency:透明度
        Gradient: false, //Gradient:倾斜度
        ApplyTo: 1, //ApplyTo:插入位置
      });
    
      //水印对象
      const waterMarks = await app.ActiveDocument.Sections.Item(1).WaterMarks;
    
      //获取水印
      const waterMark = await waterMarks.Item(1);
    
      //设置水印的透明度
      waterMark.Transparency = 0;
    }