Tag

本文介绍与演示文稿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);
    }