Skip to content

放映设置(SlideShowSettings)

放映设置对象

属性列表

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

方法列表

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

Ink

画笔对象

语法

表达式.ActivePresentation.SlideShowSettings.Ink

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

示例

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

  const app = instance.Application

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

ShowPlayToolbar

仅支持 PC 端

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

语法

表达式.ActivePresentation.SlideShowSettings.ShowPlayToolbar

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

示例

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

  const app = instance.Application

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

Run()

切换到 PPT 全屏播放状态

语法

表达式.ActivePresentation.SlideShowSettings.Run()

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

示例

js
//@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()

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

示例

js
//@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()

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

示例

js
//@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
是否打开

示例

js
//@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 }

示例

js
//@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 自由度很高,为了避免样式的修改影响功能使用,请尽量使用 topleftrightbottomtranslate 修改样式

语法

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

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

参数

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

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

Style 说明

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

示例

js
//@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()

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

示例

js
//@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()

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

示例

js
//@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()
}