WebOffice 开放平台主题
幻灯片集合(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)
}