WPS WebOffice 开放平台WPS WebOffice 开放平台 | 开发文档

深色模式

字体(Font) ​

文档的字体对象

属性列表 ​

属性说明
Bold
设置、获取选中内容为粗体
Italic
设置、获取选中内容为斜体
Underline
设置、获取选中内容的下划线类型
UnderlineColor
设置、获取选中内容的下划线类型

方法列表 ​

方法说明
Range(Start, End).Font
通过 Font 对象可以控制选中内容的字体，例如设置字体类型、字体大小等内容。
Range(Start, End).Font.Color
设置选定文字的字体颜色
Range(Start, End).Font.ColorIndex
字体颜色设置
Range(Start, End).Font.HighLight
设置选定文字的高亮颜色
Range(Start, End).Font.Name
设置选定文字的字体类型
Range(Start, End).Font.Size
设置选定文字的字体大小

Bold ​

设置、获取选中内容为粗体

语法 ​

表达式.ActiveDocument.Selection.Font.Bold

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

参数 ​

true/false

返回值 ​

true 表示粗体，false 表示非粗体，wdUndefined 表示混合

示例 ​

js
//@file=base.docx
async function example() {
  await instance.ready()

  const app = instance.Application

  // 设置内容为粗体
  app.ActiveDocument.Selection.Font.Bold = true

  // 检查内容是否为粗体
  const bold = await app.ActiveDocument.Selection.Font.Bold

  console.log('bold: ', bold)
}

Italic ​

设置、获取选中内容为斜体

语法 ​

表达式.ActiveDocument.Selection.Font.Italic

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

参数 ​

true/false

返回值 ​

true 表示斜体，false 表示非斜体，wdUndefined 表示混合

示例 ​

js
//@file=base.docx
async function example() {
  await instance.ready()

  const app = instance.Application

  // 设置内容为斜体
  app.ActiveDocument.Selection.Font.Italic = true

  // 检查内容是否为斜体
  const italic = await app.ActiveDocument.Selection.Font.Italic

  console.log('italic: ', italic)
}

Underline ​

设置、获取选中内容的下划线类型

语法 ​

表达式.ActiveDocument.Selection.Font.Underline

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

参数 ​

WdUnderline：下划线类型

返回值 ​

返回下划线类型WdUnderline，无下划线时返回 null，多下划线混合时返回 wdUndefined

示例 ​

js
//@file=base.docx
async function example() {
  await instance.ready()

  const app = instance.Application

  // 设置下划线类型为 粗波浪线
  app.ActiveDocument.Selection.Font.Underline =
    app.Enum.WdUnderline.wdUnderlineWavyHeavy

  // 获取下划线类型
  const underlineType = await app.ActiveDocument.Selection.Font.Underline

  console.log('underlineType: ', underlineType)
}

UnderlineColor ​

设置、获取选中内容的下划线类型

语法 ​

表达式.ActiveDocument.Selection.Font.UnderlineColor

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

参数 ​

16 进制的颜色值，如 #FF0000

返回值 ​

默认 #000000，无下划线时返回 null，多颜色混合时返回 wdUndefined

示例 ​

js
//@file=base.docx
async function example() {
  await instance.ready()

  const app = instance.Application

  // 设置下划线颜色为 红色
  app.ActiveDocument.Selection.Font.UnderlineColor = '#FF0000'

  // 获取下划线颜色
  const underlineColor = await app.ActiveDocument.Selection.Font.UnderlineColor

  console.log('underlineColor: ', underlineColor)
}

Range(Start, End).Font ​

通过 Font 对象可以控制选中内容的字体，例如设置字体类型、字体大小等内容。

语法 ​

表达式.ActiveDocument.Range(Start, End).Font

或者 表达式.ActiveDocument.ActiveWindow.Selection.Font

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

示例 ​

js
//@file=base.docx
async function example() {
  await instance.ready()

  const app = instance.Application

  // 字体对象
  const font = await app.ActiveDocument.Range(0, 20).Font
}

Range(Start, End).Font.Color ​

设置选定文字的字体颜色

语法 ​

表达式.ActiveDocument.Range(Start, End).Font.Color

或者 表达式.ActiveDocument.ActiveWindow.Selection.Font

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

示例 ​

js
//@file=base.docx
async function example() {
  await instance.ready()

  const app = instance.Application

  // 字体对象
  const font = await app.ActiveDocument.Range(0, 20).Font

  // 设置选定文字的字体颜色
  font.Color = '#228B22'
}

Range(Start, End).Font.ColorIndex ​

字体颜色设置

语法 ​

表达式.ActiveDocument.Range(Start, End).Font.ColorIndex = WdColorIndex

或者 表达式.ActiveDocument.ActiveWindow.Selection.Font

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

设置字体颜色时，WdColorIndex 详细可参考： Enum.WdColorIndex

示例 ​

js
//@file=base.docx
async function example() {
  await instance.ready()

  const app = instance.Application

  // 字体对象
  const font = await app.ActiveDocument.Range(0, 20).Font

  // 设置字体颜色
  font.ColorIndex = 2
}

Range(Start, End).Font.HighLight ​

设置选定文字的高亮颜色

语法 ​

表达式.ActiveDocument.Range(Start, End).Font.HighLight

或者 表达式.ActiveDocument.ActiveWindow.Selection.Font

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

示例 ​

js
//@file=base.docx
async function example() {
  await instance.ready()

  const app = instance.Application

  // 字体对象
  const font = await app.ActiveDocument.Range(0, 20).Font

  // 设置选定文字的高亮颜色
  font.HighLight = '#228B22'
}

Range(Start, End).Font.Name ​

设置选定文字的字体类型

语法 ​

表达式.ActiveDocument.Range(Start, End).Font.Name

或者 表达式.ActiveDocument.ActiveWindow.Selection.Font

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

示例 ​

js
//@file=base.docx
async function example() {
  await instance.ready()

  const app = instance.Application

  // 字体对象
  const font = await app.ActiveDocument.Range(0, 20).Font

  // 设置选定文字的字体类型
  font.Name = '宋体'
}

Range(Start, End).Font.Size ​

设置选定文字的字体大小

语法 ​

表达式.ActiveDocument.Range(Start, End).Font.Size

或者 表达式.ActiveDocument.ActiveWindow.Selection.Font

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

示例 ​

js
//@file=base.docx
async function example() {
  await instance.ready()

  const app = instance.Application

  // 字体对象
  const font = await app.ActiveDocument.Range(0, 20).Font

  // 设置选定文字的字体大小
  font.Size = 30
}