Skip to content
本页内容

幻灯片集合

Slides

幻灯片集合对象

语法

表达式.ActivePresentation.Slides

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

示例

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

  const app = instance.Application

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

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

Comments

JSSDK: v1.1.14+、WebOffice v3.4.1+ 支持

获取 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()

JSSDK: v1.1.10+、WebOffice v2.3.1+ 支持

插入新的幻灯片

语法

表达式.ActivePresentation.Slides.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)
}

FindBySlideID()

JSSDK: v1.1.10+、WebOffice v2.3.1+ 支持

根据 SlideID 获取对应 PPT 的信息

语法

表达式.ActivePresentation.Slides.FindBySlideID()

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

参数

属性数据类型默认值必填说明
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.FindBySlideID(slideId)
  console.log(info)
}

Item()

JSSDK: v1.1.14+、WebOffice v3.2.1+ 支持

获取幻灯片对象

语法

表达式.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)
}