使用 C++ 管理演示文稿中的标签和自定义数据

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

PPTX 文件——扩展名为 .pptx 的项目——采用 PresentationML 格式存储,属于 Office Open XML 规范的一部分。Office Open XML 格式定义了演示文稿中数据的结构。

在演示文稿中,幻灯片 是其中的一个元素,幻灯片部件 包含单个幻灯片的内容。幻灯片部件可以显式关联到许多部件——例如由 ISO/IEC 29500 定义的用户自定义标签(User Defined Tags)。

自定义数据(特定于演示文稿)或用户可以以标签(ITagCollection)和 CustomXmlParts(ICustomXmlPartCollection)的形式存在。

获取标签的值

在幻灯片中,标签对应于 IDocumentProperties.Keywords 属性。以下示例代码展示了如何使用 Aspose.Slides for C++ 为 Presentation 获取标签的值:

auto pres = System::MakeObject<Presentation>(u"pres.pptx");
System::String keywords = pres->get_DocumentProperties()->get_Keywords();

向演示文稿添加标签

Aspose.Slides 允许向演示文稿添加标签。标签通常由两部分组成:

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

如果需要根据特定规则或属性对某些演示文稿进行分类,向这些演示文稿添加标签可能会有所帮助。例如,若要对来自北美国家的所有演示文稿进行归类,可以创建一个 “North American” 标签,并将相关国家(美国、墨西哥、加拿大)作为其值。

以下示例代码展示了如何使用 Aspose.Slides for C++ 为 Presentation 添加标签:

auto pres = System::MakeObject<Presentation>(u"pres.pptx");

System::SharedPtr<ITagCollection> tags = pres->get_CustomData()->get_Tags();
pres->get_CustomData()->get_Tags()->idx_set(u"MyTag", u"My Tag Value");

标签也可以为 Slide 设置:

auto pres = System::MakeObject<Presentation>();

auto slide = pres->get_Slides()->idx_get(0);
slide->get_CustomData()->get_Tags()->idx_set(u"tag", u"value");

或为任意单独的 Shape 设置:

auto pres = System::MakeObject<Presentation>();

auto slide = pres->get_Slides()->idx_get(0);
auto shape = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 10.0f, 10.0f, 100.0f, 50.0f);
shape->get_TextFrame()->set_Text(u"My text");
shape->get_CustomData()->get_Tags()->idx_set(u"tag", u"value");

FAQ

我可以一次性删除演示文稿、幻灯片或形状中的所有标签吗?

可以。tag collection 支持 clear 操作,可一次性删除所有键值对。

如何在不遍历整个集合的情况下,仅通过名称删除单个标签?

TagCollection 使用 Remove(name) 操作即可通过键删除该标签。

如何检索标签名称的完整列表,以便进行分析或筛选?

tag collection 上使用 GetNamesOfTags;它会返回所有标签名称的数组。