主题
形状
Shapes
JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持
指定幻灯片上所有 Shape 对象的集合
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Shapes
表达式:文档类型应用对象
示例
//@file=base.pptx
async function example() {
await instance.ready()
const app = instance.Application
// 指定幻灯片上所有 Shape 对象的集合
const shapes = await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes
}
AddPicture()
JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持
将图片插入到当前 PPT 中
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddPicture({ FileName, LinkToFile, SaveWithDocument, Left, Top, Width, Height, Scale })
表达式:文档类型应用对象
参数
属性 | 数据类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
FileName | String | 是 | 要在其中创建 OLE 对象的文件(可以是 Blob 文件对象或者 Url 链接) | |
LinkToFile | Enum | 是 | 确定是否将图片链接到从中创建该图片的文件,详细可参考 MsoTriState | |
SaveWithDocument | Enum | 是 | 确定是否将已链接的图片插入到文档一起保存。如果 LinkToFile 为 msoFalse,则此参数必须为 msoTrue,详细可参考 MsoTriState | |
Left | Number | 是 | 图片左边缘相对于幻灯片左边缘的位置 | |
Top | Number | 是 | 图片上边缘相对于幻灯片上边缘的位置 | |
Width | Number | 否 | 图片的宽度 | |
Height | Number | 否 | 图片的高度 | |
Scale | Boolean | 否 | 按幻灯片比例计算宽高和坐标 |
示例
//@file=base.pptx
async function example() {
await instance.ready()
const app = instance.Application
// 将图片插入到当前 PPT 中
await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddPicture({
FileName:
'https://img8.file.cache.docer.com/storage/1626952237972828328/0e7c3a748ed2d065749b9659f54b679e.jpeg', // 来自「插入在线图片」的稻壳素材的图片
LinkToFile: -1,
SaveWithDocument: 0,
Left: 0.1,
Top: 0.1,
Width: 0.3,
Height: 0.3,
Scale: true
})
}
AddTextbox()
JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持
创建一个文本框。返回一个 Shape 对象,该对象代表新的文本框
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox({ Orientation, Left, Top, Width, Height, Color, Size, Scale, Bold, Italic, StrikeThrough, AlignMode })
表达式:文档类型应用对象
参数
属性 | 数据类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
Orientation | Enum | 是 | 文本打印方向,详细可参考 MsoTriState | |
Left | Number | 是 | 文本框左边缘相对于幻灯片左边缘的位置 | |
Top | Number | 是 | 文本框上边缘相对于幻灯片上边缘的位置 | |
Width | Number | 否 | 文本框的宽度 | |
Height | Number | 否 | 文本框的高度 | |
Color | String | 否 | 文本的颜色 | |
Size | Number | 否 | 文本字体的大小 | |
Scale | Boolean | 否 | 文本是否缩放 | |
Bold | Boolean | 否 | 文本是否加粗 | |
Italic | Boolean | 否 | 文本是否斜体 | |
StrikeThrough | Boolean | 否 | 文本是否删除线 | |
AlignMode | Number | 否 | 文本如何对齐,1-左对齐,2-居中对齐,3-右对齐,4-两端对齐,5-分散对齐 |
返回值
返回一个 Shape 对象,该对象代表新的文本框
示例
//@file=base.pptx
async function example() {
await instance.ready()
const app = instance.Application
// 创建一个文本框。返回一个 Shape 对象,该对象代表新的文本框
const textBox =
await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.AddTextbox({
Orientation: 0,
Left: 0.1,
Top: 0.1,
Width: 0.1,
Height: undefined,
Color: '#f00',
Size: 36,
Scale: true
})
textBox.TextFrame.TextRange.Text = '1245'
}
ReplacePicture()
JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持
替换 PPT 中选中的图片
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Shapes.ReplacePicture({ FileName, IsKeepShapeSize })
表达式:文档类型应用对象
参数
属性 | 数据类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
FileName | String/Object | 否 | 图片源。可以是 url 或者 Blob 对象,用以替换选中的图片 | |
IsKeepShapeSize | Boolean | 否 | 是否保持比例。为 true 时,原来图片对象的大小不会改变,为 false 会根据图片的宽高比例重新设置选中对象的宽高 |
示例
//@file=base.pptx
async function example() {
await instance.ready()
const app = instance.Application
// 替换 PPT 中选中的图片
await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.ReplacePicture(
{
FileName:
'https://img8.file.cache.docer.com/storage/1626952237972828328/0e7c3a748ed2d065749b9659f54b679e.jpeg', // 来自「插入在线图片」的稻壳素材的图片
IsKeepShapeSize: true
}
)
}
形状
Item()
JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持
代表绘图层中的对象,例如自选图形、任意多边形、OLE 对象或图片
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index)
表达式:文档类型应用对象
示例
//@file=base.pptx
async function example() {
await instance.ready()
const app = instance.Application
// 代表绘图层中的对象,例如自选图形、任意多边形、OLE 对象或图片
const shape =
await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1)
}
Item().ActionSettings
JSSDK: v1.1.14+、WebOffice v3.2.1+ 支持
表示 Shape 对象中的动作设定集合
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).ActionSettings
表达式:文档类型应用对象
示例
//@file=base.pptx
async function example() {
await instance.ready()
const app = instance.Application
// 表示 Shape 对象中的动作设定集合
const ActionSettings =
await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1)
.ActionSettings
}
Item().AutoShapeType
JSSDK: v1.1.14+、WebOffice v3.2.1+ 支持
返回或设置指定的 Shape 或 ShapeRange 对象的形状类型
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).AutoShapeType
表达式:文档类型应用对象
示例
//@file=base.pptx
async function example() {
await instance.ready()
const app = instance.Application
// 返回或设置指定的 Shape 或 ShapeRange 对象的形状类型
const AutoShapeType =
await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1)
.AutoShapeType
}
Item().Fill
JSSDK: v1.1.14+、WebOffice v3.2.1+ 支持
返回一个 FillFormat 对象,该对象包含指定形状的填充格式属性
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Fill
表达式:文档类型应用对象
示例
//@file=base.pptx
async function example() {
await instance.ready()
const app = instance.Application
// 返回一个 FillFormat 对象,该对象包含指定形状的填充格式属性
const Fill =
await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Fill
}
Item().Glow
JSSDK: v1.1.14+、WebOffice v3.2.1+ 支持
返回指定形状的发光格式
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Glow
表达式:文档类型应用对象
示例
//@file=base.pptx
async function example() {
await instance.ready()
const app = instance.Application
// 返回指定形状的发光格式
const Glow =
await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Glow
}
Item().HasTextFrame
JSSDK: v1.1.14+、WebOffice v3.2.1+ 支持
返回指定形状是否有文本框
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).HasTextFrame
表达式:文档类型应用对象
示例
//@file=base.pptx
async function example() {
await instance.ready()
const app = instance.Application
// 返回指定形状是否有文本框
const HasTextFrame =
await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1)
.HasTextFrame
}
Item().Height
JSSDK: v1.1.14+、WebOffice v3.2.1+ 支持
返回或设置指定对象的高度
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Height
表达式:文档类型应用对象
示例
//@file=base.pptx
async function example() {
await instance.ready()
const app = instance.Application
// 返回或设置指定对象的高度
const Height =
await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1)
.Height
}
Item().Id
JSSDK: v1.1.14+、WebOffice v3.2.1+ 支持
返回指定形状的标识符
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Id
表达式:文档类型应用对象
示例
//@file=base.pptx
async function example() {
await instance.ready()
const app = instance.Application
// 返回指定形状的标识符
const Id =
await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Id
}
Item().Left
JSSDK: v1.1.14+、WebOffice v3.2.1+ 支持
返回从形状边界框的左边缘到幻灯片左边缘的距离
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Left
表达式:文档类型应用对象
示例
//@file=base.pptx
async function example() {
await instance.ready()
const app = instance.Application
// 返回从形状边界框的左边缘到幻灯片左边缘的距离
const Left =
await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Left
}
Item().Rotation
JSSDK: v1.1.14+、WebOffice v3.2.1+ 支持
返回或设置指定形状绕 z 轴旋转的角度
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Rotation
表达式:文档类型应用对象
示例
//@file=base.pptx
async function example() {
await instance.ready()
const app = instance.Application
// 返回或设置指定形状绕 z 轴旋转的角度
const Rotation =
await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1)
.Rotation
}
Item().Shadow
JSSDK: v1.1.14+、WebOffice v3.2.1+ 支持
返回指定形状的阴影格式
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Shadow
表达式:文档类型应用对象
示例
//@file=base.pptx
async function example() {
await instance.ready()
const app = instance.Application
// 返回指定形状的阴影格式
const Shadow =
await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1)
.Shadow
}
Item().Tags
JSSDK: v1.1.14+、WebOffice v3.2.1+ 支持
返回一个代表指定对象的标签的 Tags 对象
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Tags
表达式:文档类型应用对象
示例
//@file=base.pptx
async function example() {
await instance.ready()
const app = instance.Application
// 返回一个代表指定对象的标签的 Tags 对象
const Tags =
await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Tags
}
Item().TextFrame
JSSDK: v1.1.14+、WebOffice v3.2.1+ 支持
表示 Shape 对象中的文字框架。包含文本框中的文字框架的属性和控件的对齐方式和定位的文本框架的方法
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).TextFrame
表达式:文档类型应用对象
示例
//@file=base.pptx
async function example() {
await instance.ready()
const app = instance.Application
// 表示 Shape 对象中的文字框架。包含文本框中的文字框架的属性和控件的对齐方式和定位的文本框架的方法
const TextFrame =
await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1)
.TextFrame
}
Item().Top
JSSDK: v1.1.16+、WebOffice v4.2.1+ 支持
返回/设置从形状边界框的上边缘到幻灯片上边缘的距离
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Top
表达式:文档类型应用对象
示例
//@file=base.pptx
async function example() {
await instance.ready()
const app = instance.Application
// 返回/设置从形状边界框的上边缘到幻灯片上边缘的距离
const Top =
await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Top
app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Top = 10
}
Item().Type
JSSDK: v1.1.14+、WebOffice v3.2.1+ 支持
返回单个形状或形状范围内多个形状的类型
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Type
表达式:文档类型应用对象
示例
//@file=base.pptx
async function example() {
await instance.ready()
const app = instance.Application
// 返回单个形状或形状范围内多个形状的类型
const Type =
await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Type
}
Item().Width
JSSDK: v1.1.14+、WebOffice v3.2.1+ 支持
返回或设置指定对象的宽度
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(Index).Width
表达式:文档类型应用对象
示例
//@file=base.pptx
async function example() {
await instance.ready()
const app = instance.Application
// 返回或设置指定对象的宽度
const Width =
await app.ActivePresentation.SlideShowWindow.View.Slide.Shapes.Item(1).Width
}