WebOffice 开放平台

主题

回到顶部
本页内容

标签(Tags)

获取标签集合对象

属性列表

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

方法列表

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

Count

指定对象的标签数量

语法

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

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

返回值

返回 指定对象的标签数量

示例

js
//@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

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

返回值

返回 标签集合的父级

示例

js
//@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
是
标签的值

示例

js
//@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
是
标签的名称

示例

js
//@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
是
标签的名称

示例

js
//@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 标签对象

示例

js
//@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
是
当前幻灯片标签索引

示例

js
//@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
是
当前幻灯片标签索引

示例

js
//@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 });
}