Skip to content
本页内容

幻灯片集合(Slides)

幻灯片集合对象

属性列表

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

方法列表

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

Comments

获取 Comments 评论对象

语法

表达式.ActivePresentation.Slides.Comments

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

示例

js
//@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 表示对应的总页数

示例

js
//@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 不传时,该参数无效

示例

js
//@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 信息

示例

js
//@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 幻灯片对象模型

示例

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

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