标签(Tags)

获取标签集合对象

属性列表

属性	说明
Count	指定对象的标签数量
Parent	返回标签集合的父级

方法列表

方法	说明
Add()	添加标签
Delete()	删除标签
Has()	判断标签是否存在
Item()	获取标签对象
Name()	获取标签名称
Value()	获取标签值

Count

指定对象的标签数量

语法

表达式.ActivePresentation.SlideShowWindow.View.Slide.Tags.Count

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

返回值

返回 指定对象的标签数量

示例

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

  const app = instance.Application

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

  // 幻灯片对象
  const Tags = await presentation.SlideShowWindow.View.Slide.Tags

  // 指定对象的标签数量
  const count = await Tags.Count
  console.log(count)
}

Parent

返回标签集合的父级

语法

表达式.ActivePresentation.SlideShowWindow.View.Slide.Tags.Parent

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

返回值

返回 标签集合的父级

示例

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

  const app = instance.Application

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

  // 幻灯片对象
  const Tags = await presentation.SlideShowWindow.View.Slide.Tags

  // 返回标签集合的父级
  const Parent = await Tags.Parent
  console.log(Parent)
}

Add()

添加标签

语法

表达式.ActivePresentation.SlideShowWindow.View.Slide.Tags.Add({Name,Value})

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

参数

属性	数据类型	默认值	必填	说明
Name	string		是	标签的名称
Value	string		是	标签的值

示例

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

  const app = instance.Application
  // 给当前页面添加标签
  await app.ActivePresentation.SlideShowWindow.View.Slide.Tags.Add({
    Name: 'test',
    Value: '123'
  })
}

Delete()

删除标签

语法

表达式.ActivePresentation.SlideShowWindow.View.Slide.Tags.Delete({Name})

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

参数

属性	数据类型	默认值	必填	说明
Name	string		是	标签的名称

示例

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

  const app = instance.Application
  // 给当前页面删除标签
  await app.ActivePresentation.SlideShowWindow.View.Slide.Tags.Delete({
    Name: 'test'
  })
}

Has()

判断标签是否存在

语法

表达式.ActivePresentation.SlideShowWindow.View.Slide.Tags.Has({Name})

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

参数

属性	数据类型	默认值	必填	说明
Name	string		是	标签的名称

示例

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

  const app = instance.Application
  // 给当前页面判断标签是否存在
  await app.ActivePresentation.SlideShowWindow.View.Slide.Tags.Has({
    Name: 'test'
  })
}

Item()

获取标签对象

语法

表达式.ActivePresentation.SlideShowWindow.View.Slide.Tags.Item({Name})

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

参数

属性	数据类型	默认值	必填	说明
Name	string		是	标签的名称

返回值

返回 Tag 标签对象

示例

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

  const app = instance.Application
  // 获取名为Tags的Tag对象
  await app.ActivePresentation.SlideShowWindow.View.Slide.Tags.Item({Name:'test'})
}

Name()

获取标签名称

语法

表达式.ActivePresentation.SlideShowWindow.View.Slide.Tags.Name({Index})

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

参数

属性	数据类型	默认值	必填	说明
Index	Number		是	当前幻灯片标签索引

示例

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

  const app = instance.Application;
  // 获取当前幻灯片第二个标签名称
  const Name = await app.ActivePresentation.SlideShowWindow.View.Slide.Tags.Name({ Index: 2 });
}

Value()

获取标签值

语法

表达式.ActivePresentation.SlideShowWindow.View.Slide.Tags.Value({Index})

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

参数

属性	数据类型	默认值	必填	说明
Index	Number		是	当前幻灯片标签索引

示例

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

  const app = instance.Application;
  // 获取当前幻灯片第二个标签值
  const Name = await app.ActivePresentation.SlideShowWindow.View.Slide.Tags.Value({ Index: 2 });
}