Gérer les balises et les données personnalisées dans les présentations avec C++
Stockage des données dans les fichiers de présentation
Les fichiers PPTX - éléments avec l’extension .pptx - sont stockés au format PresentationML, qui fait partie de la spécification Office Open XML. Le format Office Open XML définit la structure des données contenues dans les présentations.
Dans une présentation, une diapositive est l’un des éléments ; une partie de diapositive contient le contenu d’une seule diapositive. Une partie de diapositive peut avoir des relations explicites avec de nombreuses parties - comme les balises définies par l’utilisateur - définies par la norme ISO/IEC 29500.
Des données personnalisées (spécifiques à une présentation) ou utilisateur peuvent exister sous forme de balises (ITagCollection) et de CustomXmlParts (ICustomXmlPartCollection).
Obtenir les valeurs des balises
Dans les diapositives, une balise correspond à la propriété IDocumentProperties.Keywords. Ce code d’exemple montre comment obtenir la valeur d’une balise avec Aspose.Slides pour C++ pour Presentation :
auto pres = System::MakeObject<Presentation>(u"pres.pptx");
System::String keywords = pres->get_DocumentProperties()->get_Keywords();
Ajouter des balises aux présentations
Aspose.Slides vous permet d’ajouter des balises aux présentations. Une balise se compose généralement de deux éléments :
- le nom d’une propriété personnalisée -
MyTag - la valeur de la propriété personnalisée -
My Tag Value
Si vous devez classer certaines présentations en fonction d’une règle ou propriété spécifique, vous pouvez tirer parti de l’ajout de balises à ces présentations. Par exemple, si vous souhaitez regrouper ou catégoriser toutes les présentations provenant de pays nord-américains, vous pouvez créer une balise North American et attribuer aux pays concernés (États-Unis, Mexique et Canada) comme valeurs.
Ce code d’exemple montre comment ajouter une balise à une Presentation en utilisant Aspose.Slides pour C++ :
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");
Les balises peuvent également être définies pour 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");
Ou pour tout Shape individuel :
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
Puis-je supprimer toutes les balises d’une présentation, d’une diapositive ou d’une forme en une seule opération ?
Oui. La collection de balises prend en charge une opération clear qui supprime toutes les paires clé-valeur d’un coup.
Comment supprimer une balise unique par son nom sans parcourir toute la collection ?
Utilisez l’opération Remove(name) sur TagCollection pour supprimer la balise par sa clé.
Comment récupérer la liste complète des noms de balises pour l’analyse ou le filtrage ?
Utilisez GetNamesOfTags sur la collection de balises ; elle renvoie un tableau contenant tous les noms de balises.