管理标签和自定义数据

演示文稿文件中的数据存储

PPTX 文件 - 以 .pptx 扩展名结尾的项目 - 以 PresentationML 格式存储，该格式是 Office Open XML 规范的一部分。Office Open XML 格式定义了演示文稿中包含的数据的结构。

在演示文稿中，一个 幻灯片 是其元素之一，一个 幻灯片部分 包含单个幻灯片的内容。幻灯片部分可以有与许多部分（如用户定义标签）明确的关系，这些关系由 ISO/IEC 29500 定义。

自定义数据（特定于演示文稿）或用户可以作为标签 (ITagCollection) 和 CustomXmlParts (ICustomXmlPartCollection) 存在。

标签本质上是字符串-键对值。

获取标签的值

在幻灯片中，标签对应于 IDocumentProperties.getKeywords() 和 IDocumentProperties.setKeywords() 方法。以下示例代码展示了如何使用 Aspose.Slides for Java 获取 Presentation 中标签的值：

Presentation pres = new Presentation("pres.pptx");
try{
    String keywords = pres.getDocumentProperties().getKeywords();
} finally {
    if (pres != null) pres.dispose();
}

向演示文稿添加标签

Aspose.Slides 允许您向演示文稿添加标签。标签通常由两个项目组成：

• 自定义属性的名称 - MyTag
• 自定义属性的值 - My Tag Value

如果您需要根据特定规则或属性对某些演示文稿进行分类，则可以通过向这些演示文稿添加标签来受益。例如，如果您想将所有来自北美国家的演示文稿分类或放在一起，您可以创建一个北美标签，然后将相关国家（美国、墨西哥和加拿大）分配为值。

以下示例代码展示了如何使用 Aspose.Slides for Java 向 Presentation 添加标签：

Presentation pres = new Presentation("pres.pptx");
try {
    ITagCollection tags = pres.getCustomData().getTags();
    pres.getCustomData().getTags().set_Item("MyTag", "My Tag Value");
} finally {
    if (pres != null) pres.dispose();
}

标签也可以为 Slide 设置：

Presentation pres = new Presentation();
try {
    ISlide slide = pres.getSlides().get_Item(0);
    slide.getCustomData().getTags().set_Item("tag", "value");
} finally {
    if (pres != null) pres.dispose();
}

或者为任何单独的 Shape 设置：

Presentation pres = new Presentation();
try {
    ISlide slide = pres.getSlides().get_Item(0);
    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 10, 100, 50);
    shape.getTextFrame().setText("My text");
    shape.getCustomData().getTags().set_Item("tag", "value");
} finally {
    if (pres != null) pres.dispose();
}