Hantera taggar och anpassad data i presentationer på Android

Översikt

Denna artikel förklarar hur Aspose.Slides arbetar med taggar och anpassad data i PowerPoint-presentationer. Den ger en kort översikt över hur data lagras i PPTX-filer, påpekar att presentationsspecifik data kan finnas som taggar och anpassade XML-delar, och beskriver taggar som nyckel‑värde‑strängpar.

Den visar också hur man läser taggvärden och hur man lägger till taggar i en presentation, en enskild slide eller en form. Dessutom behandlar artikeln vanliga tagghanteringsuppgifter såsom att rensa alla taggar, ta bort en tagg efter namn och hämta listan med taggnamn.

Datainlagring i presentationsfiler

PPTX‑filer — objekt med filändelsen .pptx — lagras i PresentationML‑formatet, som är en del av Office Open XML‑specifikationen. Office Open XML‑formatet definierar strukturen för data som finns i presentationer.

Med en slide som ett av elementen i presentationer innehåller en slide part innehållet i en enskild slide. En slide part får ha explicita relationer till många delar — såsom User Defined Tags — som definieras av ISO/IEC 29500.

Anpassad data (specifik för en presentation) eller användare kan finnas som taggar (ITagCollection) och CustomXmlParts (ICustomXmlPartCollection).

Taggar är i huvudsak nyckel‑sträng‑parvärden.

Hämta värden för taggar

I slides motsvarar en tagg metoderna IDocumentProperties.getKeywords() och IDocumentProperties.setKeywords() . Detta exempel visar hur du hämtar ett taggvärde med Aspose.Slides för Android via Java för Presentation:

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

Lägg till taggar i presentationer

Aspose.Slides låter dig lägga till taggar i presentationer. En tagg består vanligtvis av två element:

• namnet på en anpassad egenskap – MyTag
• värdet på den anpassade egenskapen – My Tag Value

Om du behöver klassificera vissa presentationer baserat på en specifik regel eller egenskap kan du ha nytta av att lägga till taggar i dessa presentationer. Till exempel, om du vill gruppera alla presentationer från Nordamerikanska länder tillsammans kan du skapa en Nordamerikansk tagg och sedan tilldela de relevanta länderna (USA, Mexiko och Kanada) som värden.

Detta exempel visar hur du lägger till en tagg i en Presentation med Aspose.Slides för Android via Java:

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();
}

Taggar kan också sättas för 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();
}

Eller någon enskild 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();
}

Begränsningar

Taggar som läggs till via samlingen för anpassade data‑taggar med getCustomData().getTags() lagras endast i PowerPoint‑filen. De överförs inte till PDF‑taggstrukturen när presentationen exporteras till PDF. Följaktligen kan en anpassad identifierare som tilldelats som en tagg inte hämtas från den taggade PDF‑filen.

Workaround: Du kan lagra en anpassad identifierare i objektets Alt Text (t.ex. shape.setAlternativeText("MyId")). Efter export till PDF kan Alt Text visas i PDF‑taggstrukturen.

Vanliga frågor

Kan jag ta bort alla taggar från en presentation, slide eller form i en operation?

Ja. tag collection stöder en clear‑operation som tar bort alla nyckel‑värde‑par på en gång.

Hur tar jag bort en enskild tagg efter namn utan att iterera över hela samlingen?

Använd remove(name)‑operationen på tag collection för att ta bort taggen efter dess nyckel.

Hur kan jag hämta den kompletta listan med taggnamn för analys eller filtrering?

Använd getNamesOfTags på tag collection; den returnerar en array med alla taggnamn.