幻灯片集合(Slides)

幻灯片集合对象

属性列表

属性	说明
Comments	获取 Comments 评论对象
Count	获取总页数

方法列表

方法	说明
AddSlide()	插入新的幻灯片
FindBySlideID2()	根据 SlideID 获取对应 PPT 的信息
Item()	获取幻灯片对象

Comments

获取 Comments 评论对象

语法

表达式.ActivePresentation.Slides.Comments

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

示例

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

  const app = instance.Application

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

  // 幻灯片对象
  const slides = await presentation.Slides

  // 获取 Comments 评论对象
  await slides.Comments
}

Count

获取总页数

语法

表达式.ActivePresentation.Slides.Count

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

返回值

返回 Number 表示对应的总页数

示例

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

  const app = instance.Application

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

  // 幻灯片对象
  const slides = await presentation.Slides

  // 获取总页数
  const count = await slides.Count
  console.log(count)
}

AddSlide()

插入新的幻灯片

语法

表达式.ActivePresentation.Slides.AddSlide()

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

提示

🔔 需确保LayoutUrl文件地址可在线访问下载，如相关接口仍然报错errno:10000,result:"invalidDomain"，可以通过社区向我们提供应用appID及业务域名，我们后台进行域名配置，参考相关讨论：社区-AddSlide,

参数

属性	数据类型	默认值	必填	说明
Index	number		否	新幻灯片插入的位置，不传或参数小于 0 时插入到当前幻灯片的后面
CustomLayout	object		否	本地版式的类型，不传时默认插入空白幻灯片
LayoutUrl	string		否	在线 ppt 文件的链接，如传递了该参数，layoutType 会被忽略，优先用在线 ppt 文件内的版式，并返回一个 promise 通知结果
LayoutIndex	number		否	表示新建幻灯片需要使用在线文件的第几个版式，layoutUrl 不传时，该参数无效

示例

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

  const app = instance.Application
  // 插入新的空白幻灯片
  const Index = await app.ActivePresentation.SlideShowWindow.View.Slide
    .SlideIndex

  await app.ActivePresentation.Slides.AddSlide(Index)
}

FindBySlideID2()

根据 SlideID 获取对应 PPT 的信息

语法

表达式.ActivePresentation.Slides.FindBySlideID2()

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

参数

属性	数据类型	默认值	必填	说明
SlideID	Number		是	SlideID，可通过 ActivePresentation.SlideShowWindow.View.Slide.SlideID 获取

返回值

对应的 PPT 信息

示例

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

  const app = instance.Application

  let slideId = await app.ActivePresentation.SlideShowWindow.View.Slide.SlideID

  // 根据 SlideID 获取对应 PPT 的信息
  const info = await app.ActivePresentation.Slides.FindBySlideID2(slideId)
  console.log(info)
}

Item()

获取幻灯片对象

语法

表达式.ActivePresentation.Slides.Item()

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

参数

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

返回值

返回 Slide 幻灯片对象模型

示例

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

  const app = instance.Application
  // 获取幻灯片单个对象
  await app.ActivePresentation.Slides.Item(1)
}