金山文档开放平台

主题

回到顶部
本页内容

文字组件水印操作相关 API

水印对象

ActiveDocument.Sections.Item(Index).WaterMarks

水印对象

语法

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

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

参数

属性类型默认值必填说明
Index
number
是
第 Index 个代表所选内容、范围或文档中的部分

示例 

//@file=base.docx
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()

插入模板水印

语法

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

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

参数

属性数据类型默认值必填说明
Index
number
是
使用预设的模板水印的索引
ApplyTo
number
否
插入的位置：0-当前节，1-整个文档

示例 

//@file=base.docx
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()

插入文字水印

语法

表达式.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
是
倾斜度
ApplyTo
number
整个文档
是
插入位置

示例 

//@file=base.docx
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()

编辑水印

语法

表达式.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
整个文档
是
插入位置

示例 

//@file=base.docx
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()

删除水印

语法

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

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

示例 

//@file=base.docx
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)

单个水印对象

语法

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

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

参数

属性类型默认值必填说明
Index
number
是
第 Index 个水印对象

示例 

//@file=base.docx
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

水印的文本设置

语法

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

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

示例 

//@file=base.docx
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

水印的字体类型设置

语法

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

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

示例 

//@file=base.docx
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

水印的字体颜色设置

语法

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

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

示例 

//@file=base.docx
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

水印的字体大小设置

语法

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

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

示例 

//@file=base.docx
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

水印的倾斜度设置

语法

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

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

示例 

//@file=base.docx
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

水印的透明度设置

语法

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

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

示例 

//@file=base.docx
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
}