本文介绍与演示文稿Tag相关的API。
Tags
ActivePresentation.SlideShowWindow.View.Slide.Tags
获取演示文稿中的所有标签。
JS-SDK V1.1.14及以上版本支持此功能。
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Tags
表达式:文档类型应用对象
示例
async function example() { await instance.ready(); const app = instance.Application; //获取演示文稿对象 const presentation = await app.ActivePresentation; //获取所有标签 const view = await presentation.SlideShowWindow.View.Slide.Tags; }
方法
ActivePresentation.SlideShowWindow.View.Slide.Tags.Item()
通过Item()
方法,您可以获取单个标签对象。
JS-SDK V1.1.14及以上版本支持此功能。
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Tags.Item(Index)
表达式:文档类型应用对象
参数
属性
数据类型
是否必填
描述
Index
Number
是
幻灯片序列号。
示例
async function example() { await instance.ready(); const app = instance.Application; //获取单个标签对象 await app.ActivePresentation.SlideShowWindow.View.Slide.Tags.Item(1); }
ActivePresentation.SlideShowWindow.View.Slide.Tags.Add()
通过Add()
方法,您可以添加标签。
JS-SDK V1.1.14及以上版本支持此功能。
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Tags.Add({Name,Value})
表达式:文档类型应用对象
参数
属性
数据类型
是否必填
描述
Name
String
是
标签的名称。
Value
String
是
标签的值。
示例
async function example() { await instance.ready(); const app = instance.Application; //添加标签 await app.ActivePresentation.SlideShowWindow.View.Slide.Tags.Add({Name:'test',Value:'123'}); }
ActivePresentation.SlideShowWindow.View.Slide.Tags.Delete()
通过Delete()
方法,您可以删除指定标签。
JS-SDK V1.1.14及以上版本支持此功能。
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Tags.Delete({Name})
表达式:文档类型应用对象
参数
属性
数据类型
是否必填
描述
Name
String
是
标签的名称。
示例
async function example() { await instance.ready(); const app = instance.Application; //删除标签 await app.ActivePresentation.SlideShowWindow.View.Slide.Tags.Delete({Name:'test'}); }
ActivePresentation.SlideShowWindow.View.Slide.Tags.Has()
通过Has()
方法,您可以判断指定标签是否存在。
JS-SDK V1.1.14及以上版本支持此功能。
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Tags.Has({Name})
表达式:文档类型应用对象
参数
属性
数据类型
是否必填
描述
Name
String
是
标签的名称。
示例
async function example() { await instance.ready(); const app = instance.Application; //判断标签是否存在 await app.ActivePresentation.SlideShowWindow.View.Slide.Tags.Has({Name:'test'}); }
ActivePresentation.SlideShowWindow.View.Slide.Tags.Name()
通过Name()
方法,您可以获取标签名称。
JS-SDK V1.1.14及以上版本支持此功能。
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Tags.Name({Index})
表达式:文档类型应用对象
参数
属性
数据类型
是否必填
描述
Index
Number
是
当前幻灯片标签索引
示例
async function example() { await instance.ready(); const app = instance.Application; // 获取当前幻灯片第二个T标签名称 const Name = await app.ActivePresentation.SlideShowWindow.View.Slide.Tags.Name({ Index: 2 }); }
ActivePresentation.SlideShowWindow.View.Slide.Tags.Value()
通过Value()
方法,您可以获取标签值。
JS-SDK V1.1.14及以上版本支持此功能。
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Tags.Value({Index})
表达式:文档类型应用对象
参数
属性
数据类型
是否必填
描述
Index
Number
是
当前幻灯片标签索引
示例
async function example() { await instance.ready(); const app = instance.Application; // 获取当前幻灯片第二个标签值 const Name = await app.ActivePresentation.SlideShowWindow.View.Slide.Tags.Value({ Index: 2 }); }
属性
ActivePresentation.SlideShowWindow.View.Slide.Tags.Count
通过Count
属性,您可以获取演示文稿的标签数量。
JS-SDK V1.1.14及以上版本支持此功能。
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Tags.Count
表达式:文档类型应用对象
示例
async function example() { await instance.ready(); const app = instance.Application; //获取演示文稿对象 const presentation = await app.ActivePresentation; //获取所有标签 const view = await presentation.SlideShowWindow.View.Slide.Tags; //获取标签数量 const count = await view.Count; console.log(count); }
ActivePresentation.SlideShowWindow.View.Slide.Tags.Parent
通过Parent
属性,您可以获取所有标签的父对象。
JS-SDK V1.1.14及以上版本支持此功能。
语法
表达式.ActivePresentation.SlideShowWindow.View.Slide.Tags.Parent
表达式:文档类型应用对象
示例
async function example() { await instance.ready(); const app = instance.Application; //获取演示文稿对象 const presentation = await app.ActivePresentation; //获取所有标签 const view = await presentation.SlideShowWindow.View.Slide.Tags; //获取标签集合的父对象 const Parent = await view.Parent; console.log(Parent); }