放映设置(SlideShowSettings)

放映设置对象

属性列表

属性	说明
Ink	画笔对象
ShowPlayToolbar	【播放模式】显示/隐藏工具栏

方法列表

方法	说明
Run()	切换到 PPT 全屏播放状态
OpenRemarkSpeaker()	【播放模式】打开备注视图
SetCountDown()	【播放模式】打开倒计时
SetMiniThumbnailVisible()	打开/关闭播放缩略图的方法
SetPlayInkPosition()	【播放模式】修改画笔工具样式
SetPlayToolbarPosition()	【播放模式】修改工具栏样式
StartAutoPlay()	【播放模式】开启自动播放
StopAutoPlay()	停止自动翻页

Ink

画笔对象

语法

表达式.ActivePresentation.SlideShowSettings.Ink

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

示例

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

  const app = instance.Application

  // 画笔对象
  await app.ActivePresentation.SlideShowSettings.Ink
}

ShowPlayToolbar

仅支持 PC 端

【播放模式】显示/隐藏工具栏

语法

表达式.ActivePresentation.SlideShowSettings.ShowPlayToolbar

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

示例

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

  const app = instance.Application

  // 显示隐藏工具栏
  app.ActivePresentation.SlideShowSettings.ShowPlayToolbar = false
}

Run()

切换到 PPT 全屏播放状态

语法

表达式.ActivePresentation.SlideShowSettings.Run()

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

示例

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

  const app = instance.Application

  // Slide 设置对象
  const SlideShowSettings = await app.ActivePresentation.SlideShowSettings

  // 进入幻灯片播放模式
  await SlideShowSettings.Run()
}

OpenRemarkSpeaker()

【播放模式】打开备注视图

语法

表达式.ActivePresentation.SlideShowSettings.OpenRemarkSpeaker()

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

示例

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

  const app = instance.Application

  // Slide 设置对象
  const SlideShowSettings = await app.ActivePresentation.SlideShowSettings

  // 进入幻灯片播放模式
  await SlideShowSettings.Run()

  // 打开备注视图
  await SlideShowSettings.OpenRemarkSpeaker()
}

SetCountDown()

仅支持 PC 端

【播放模式】打开倒计时

语法

表达式.ActivePresentation.SlideShowSettings.SetCountDown()

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

示例

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

  const app = instance.Application

  // Slide 设置对象
  const SlideShowSettings = await app.ActivePresentation.SlideShowSettings

  // 进入幻灯片播放模式
  await SlideShowSettings.Run()

  // 打开倒计时
  await SlideShowSettings.SetCountDown()
}

SetMiniThumbnailVisible()

仅支持 PC 端

打开/关闭播放缩略图的方法

语法

表达式.ActivePresentation.SlideShowSettings.SetMiniThumbnailVisible()

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

参数

传入一个布尔值，表明打开或者关闭缩略图。

属性	数据类型	默认值	必填	说明
Visible	Boolean	false	是	是否打开

示例

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

  const app = instance.Application

  // 打开缩略图
  await app.ActivePresentation.SlideShowSettings.SetMiniThumbnailVisible(true)
}

SetPlayInkPosition()

仅支持 PC 端

【播放模式】修改画笔工具样式

语法

表达式.ActivePresentation.SlideShowSettings.SetPlayInkPosition({ Style })

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

参数

传入一个布尔值，表明打开或者关闭缩略图。

属性	数据类型	默认值	必填	说明
Style	Object		是	样式，传入参数类似为 { left: 100px }

示例

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

  const app = instance.Application

  // Slide 设置对象
  const SlideShowSettings = await app.ActivePresentation.SlideShowSettings

  // 进入幻灯片播放模式
  await SlideShowSettings.Run()

  // 修改画笔工具样式
  await SlideShowSettings.SetPlayInkPosition({
    Style: { background: 'deepskyblue' } // 画笔工具样式
  })
}

SetPlayToolbarPosition()

仅支持 PC 端

【播放模式】修改工具栏样式

注意：该 API 自由度很高，为了避免样式的修改影响功能使用，请尽量使用 top、left、right、bottom、translate 修改样式

语法

表达式.ActivePresentation.SlideShowSettings.SetPlayToolbarPosition({ Style })

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

参数

传入一个布尔值，表明打开或者关闭缩略图。

属性	数据类型	默认值	必填	说明
Style	Object		是	样式

Style 说明

属性	数据类型	说明
Show	Object	显示时的样式，传入参数类似为 { left: 100px }
Hidden	Object	隐藏时的样式

示例

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

  const app = instance.Application

  // Slide 设置对象
  const SlideShowSettings = await app.ActivePresentation.SlideShowSettings

  // 进入幻灯片播放模式
  await SlideShowSettings.Run()

  // 修改工具栏样式
  await SlideShowSettings.SetPlayToolbarPosition({
    Style: {
      Show: { top: '10px' }, // style 样式，工具栏显示时的位置
      Hidden: { top: '-100px' } // style 样式，工具栏隐藏时的位置
    }
  })
}

StartAutoPlay()

仅支持 PC 端

【播放模式】开启自动播放

语法

表达式.ActivePresentation.SlideShowSettings.StartAutoPlay()

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

示例

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

  const app = instance.Application

  // Slide 设置对象
  const SlideShowSettings = await app.ActivePresentation.SlideShowSettings

  // 进入幻灯片播放模式
  await SlideShowSettings.Run()

  // 开启自动播放
  await SlideShowSettings.StartAutoPlay()
}

StopAutoPlay()

仅支持 PC 端

停止自动翻页

语法

表达式.ActivePresentation.SlideShowWindow.View.StopAutoPlay()

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

示例

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

  const app = instance.Application

  // Slide 设置对象
  const SlideShowSettings = await app.ActivePresentation.SlideShowSettings

  // 进入幻灯片播放模式
  await SlideShowSettings.Run()

  // 关闭自动播放
  await SlideShowSettings.StopAutoPlay()
}