超链接(Hyperlinks)

超链接对象集合

属性列表

属性	说明
Count	超链接对象集合的数量

方法列表

方法	说明
Item()	获取超链接对象
Item().Address	设置目标文档的 Internet 地址（URL）
Item().TextToDisplay	设置不与图形相关联的超链接的显示文字

Count

超链接对象集合的数量

语法

表达式.ActivePresentation.SlideShowWindow.View.Slide.Hyperlinks.Count

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

示例

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

  const app = instance.Application

  // 演示文稿对象
  const presentation = await app.ActivePresentation

  // 获取当前页超链接对象
  const hyperlinks = await presentation.SlideShowWindow.View.Slide.Hyperlinks

  // 超链接对象的数量
  const count = await hyperlinks.Count
  console.log(count)
}

Item()

获取超链接对象

语法

表达式.ActivePresentation.SlideShowWindow.View.Slide.Hyperlinks.Item(Index)

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

参数

属性	数据类型	默认值	必填	说明
Index	number		是	幻灯片序列 从 1 开始

返回值

返回 Hyperlink 幻灯片对象模型

示例

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

  const app = instance.Application
  // 获取超链接单个对象
  await app.ActivePresentation.SlideShowWindow.View.Slide.Hyperlinks.Item(1)
}

Item().Address

设置目标文档的 Internet 地址（URL）

语法

表达式.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().ActionSettings.Item(Index).Hyperlink.Address

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

示例

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

  const app = instance.Application

  // 添加文本框
  const textBox =
    await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox({
      Orientation: -1,
      Left: 30,
      Top: 30,
      Width: 100,
      Height: 30,
      Color: '#ff0',
      Size: 24,
      Scale: false
    })

  // 显示文本
  textBox.ActionSettings(1).Hyperlink.TextToDisplay = 'WebOffice开放平台'

  // 对应链接
  textBox.ActionSettings(1).Hyperlink.Address = 'https://solution.wps.cn'

  //获取超链接地址
  const address =
    await app.ActivePresentation.SlideShowWindow.View.Slide.Hyperlinks.Item(1)
      .Address
}

Item().TextToDisplay

设置不与图形相关联的超链接的显示文字

语法

表达式.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox().ActionSettings.Item(Index).Hyperlink.TextToDisplay

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

示例

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

  const app = instance.Application

  // 添加文本框
  const textBox =
    await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox({
      Orientation: -1,
      Left: 30,
      Top: 30,
      Width: 100,
      Height: 30,
      Color: '#ff0',
      Size: 24,
      Scale: false
    })

  // 显示文本
  textBox.ActionSettings(1).Hyperlink.TextToDisplay = 'WebOffice开发平台'

  // 对应链接
  textBox.ActionSettings(1).Hyperlink.Address = 'https://solution.wps.cn'
}