Hämta och uppdatera presentationsinformation i C++

Vad den här sidan handlar om

Utforska bilder, struktur och metadata i PowerPoint- och OpenDocument-presentationer med C++ för snabbare insikter och smartare innehållsgranskning.

Översikt

Aspose.Slides kan identifiera ett presentationsformat och läsa dess dokumentmetadata utan att skapa ett komplett presentationsobjektmodell. Detta är användbart när du behöver klassificera filer, bygga ett register eller inspektera egenskaper innan du bestämmer dig för att ladda och bearbeta presentationsinnehållet.

Den här artikeln demonstrerar lättviktig inspektion via PresentationFactory och IPresentationInfo, samt riktade uppdateringar via IDocumentProperties.

Kontrollera ett presentationsformat

Om du redan har en laddad presentation, se Determine the Original Presentation Format för detektering efter inläsning och begränsningarna för äldre PPT-, PPS- och POT-strömmar.

Använd IPresentationFactory::GetPresentationInfo för att inspektera en fil utan att skapa en Presentation‑instans. Metoden IPresentationInfo::get_LoadFormat rapporterar det identifierade formatet, såsom PPTX, PPT eller ODP.

#include <DOM/IPresentationInfo.h>
#include <DOM/PresentationFactory.h>
#include <LoadFormat.h>
#include <system/array.h>
#include <system/console.h>
#include <system/object_ext.h>
#include <system/string.h>

using namespace Aspose::Slides;
using namespace System;

auto fileNames = MakeArray<String>({u"pres.pptx", u"pres.ppt", u"pres.odp"});

for (const auto& fileName : fileNames)
{
    auto presentationInfo = PresentationFactory::get_Instance()->GetPresentationInfo(fileName);
    Console::WriteLine(String::Format(u"{0}: {1}", fileName, ObjectExt::ToString(presentationInfo->get_LoadFormat())));
}

Bygg ett lättviktigt presentationsregister

När du bearbetar många presentationsfiler kan du behöva ett kompakt register för validering, indexering eller ett dokumenthanteringssystem. I detta scenario, använd IPresentationFactory::GetPresentationInfo för att få ett IPresentationInfo‑objekt och anropa sedan IPresentationInfo::ReadDocumentProperties för att läsa dokumentmetadata. Detta tillvägagångssätt skapar inte en Presentation‑instans eller kräver att du traverserar hela presentationsobjektmodellen.

De utökade egenskaper som exponeras av IDocumentProperties ger följande registervärden:

Metod	Registervärde
get_Slides	Totalt antal bilder.
get_HiddenSlides	Antal dolda slides.
get_Notes	Antal slides som innehåller anteckningar.
get_Paragraphs	Totalt antal stycken, när tillgängligt.
get_Words	Totalt antal ord.
get_MultimediaClips	Totalt antal ljud- och videoklipp.

Följande exempel läser dessa värden utan att skapa ett Presentation‑objekt och skriver ut ett kompakt register. Det kombinerar också IDocumentProperties::get_HeadingPairs med IDocumentProperties::get_TitlesOfParts för att visa innehållsgrupper såsom teckensnitt, teman och bildrubriker.

#include <DOM/IDocumentProperties.h>
#include <DOM/IHeadingPair.h>
#include <DOM/IPresentationInfo.h>
#include <DOM/PresentationFactory.h>
#include <LoadFormat.h>
#include <system/console.h>
#include <system/io/path.h>
#include <system/object_ext.h>
#include <system/string.h>

using namespace Aspose::Slides;
using namespace System;
using namespace System::IO;

auto filePath = String(u"sample.pptx");
auto presentationInfo = PresentationFactory::get_Instance()->GetPresentationInfo(filePath);
auto documentProperties = presentationInfo->ReadDocumentProperties();

Console::WriteLine(String::Format(u"File: {0}", Path::GetFileName(filePath)));
Console::WriteLine(String::Format(u"Format: {0}", ObjectExt::ToString(presentationInfo->get_LoadFormat())));
Console::WriteLine(String::Format(u"Title: {0}", documentProperties->get_Title()));
Console::WriteLine(String::Format(u"Author: {0}", documentProperties->get_Author()));
Console::WriteLine(u"Statistics:");
Console::WriteLine(String::Format(u"  Slides: {0}", documentProperties->get_Slides()));
Console::WriteLine(String::Format(u"  Hidden slides: {0}", documentProperties->get_HiddenSlides()));
Console::WriteLine(String::Format(u"  Slides with notes: {0}", documentProperties->get_Notes()));
Console::WriteLine(String::Format(u"  Paragraphs: {0}", documentProperties->get_Paragraphs()));
Console::WriteLine(String::Format(u"  Words: {0}", documentProperties->get_Words()));
Console::WriteLine(String::Format(u"  Multimedia clips: {0}", documentProperties->get_MultimediaClips()));

auto headingPairs = documentProperties->get_HeadingPairs();
auto titlesOfParts = documentProperties->get_TitlesOfParts();
auto partIndex = 0;

if (headingPairs == nullptr || titlesOfParts == nullptr || headingPairs->get_Length() == 0 || titlesOfParts->get_Length() == 0)
{
    Console::WriteLine(u"Content groups: not available");
}
else
{
    Console::WriteLine(u"Content groups:");

    for (const auto& headingPair : headingPairs)
    {
        auto partCount = headingPair->get_Count();
        Console::WriteLine(String::Format(u"  {0} ({1})", headingPair->get_Name(), partCount));

        for (auto partOffset = 0; partOffset < partCount && partIndex < titlesOfParts->get_Length(); partOffset++)
        {
            Console::WriteLine(String::Format(u"    - {0}", titlesOfParts[partIndex]));
            partIndex++;
        }
    }

    if (partIndex < titlesOfParts->get_Length())
    {
        Console::WriteLine(u"  Other parts:");

        while (partIndex < titlesOfParts->get_Length())
        {
            Console::WriteLine(String::Format(u"    - {0}", titlesOfParts[partIndex]));
            partIndex++;
        }
    }
}

Varje IHeadingPair tillhandahåller ett gruppnamn via IHeadingPair::get_Name och antalet objekt i den gruppen via IHeadingPair::get_Count. IDocumentProperties::get_TitlesOfParts returnerar en platt, ordnad array, så konsumera antalet på varandra följande titlar som anges av varje rubrikpar.

Lagrad metadata och formatbegränsningar

Registeregenskaperna som returneras av IPresentationInfo::ReadDocumentProperties speglar metadata som finns i källdokumentet. Aspose.Slides laddar inte och traverserar presentationsobjektmodellen för att omberäkna dessa värden för detta anrop. Saknade egenskaper representeras av standardvärden, och lagrade värden kan vara föråldrade om programmet som senast sparade filen inte uppdaterade dess dokumentegenskaper.

PPTX: Formatet tillhandahåller utökade dokumentegenskaper för bild, anteckning, dold bild, stycke, ord och multimediantal, samt rubrikpar och deltitlar. Tillgänglighet beror på vilka egenskaper som skrevs av dokumentproducenten.
PPT: Det binära formatet kan lagra motsvarande dokument‑sammanfattningsegenskaper. Om en egenskap saknas eller inte uppdaterades av dokumentproducenten, returnerar Aspose.Slides dess lagrade eller standardvärde snarare än att beräkna det från bilderna.
ODP: OpenDocument-metadata ger allmänna dokuments statistik, såsom sid-, stycke- och ordantal, men dessa värden motsvarar inte varje PowerPoint‑specifik utökad egenskap. Metadata för dolda bilder, anteckningsbilder, multimedia, rubrikpar och deltitlar kan vara otillgängliga, och registeregenskaperna kan returnera standardvärden. Behandla inte ett nollvärde eller en tom array som ett auktoritativt bevis på att motsvarande innehåll saknas.

Använd den lättviktiga metadata‑metoden för register och preliminära kontroller. Ladda presentationen och inspektera dess levande objektmodell när resultatet måste återspegla förändringar i minnet eller när du behöver verifiera det faktiska presentationsinnehållet.

Uppdatera presentationsegenskaper

Egenskaperna som returneras av IPresentationInfo::ReadDocumentProperties kan också ändras utan att skapa en Presentation‑instans. Tillämpa ändringarna med IPresentationInfo::UpdateDocumentProperties, och skriv sedan den bundna presentationen med IPresentationInfo::WriteBindedPresentation.

Följande bild visar de ursprungliga dokumentegenskaperna.

Original document properties of the PowerPoint presentation

Följande exempel ändrar titeln och den senaste sparningstiden och skriver resultatet till en ny fil:

#include <DOM/IDocumentProperties.h>
#include <DOM/IPresentationInfo.h>
#include <DOM/PresentationFactory.h>
#include <system/date_time.h>
#include <system/string.h>

using namespace Aspose::Slides;
using namespace System;

auto sourceFile = String(u"sample.pptx");
auto outputFile = String(u"sample_with_updated_properties.pptx");
auto presentationInfo = PresentationFactory::get_Instance()->GetPresentationInfo(sourceFile);
auto documentProperties = presentationInfo->ReadDocumentProperties();

documentProperties->set_Title(u"Quarterly sales report");
documentProperties->set_LastSavedTime(DateTime::get_UtcNow());

presentationInfo->UpdateDocumentProperties(documentProperties);
presentationInfo->WriteBindedPresentation(outputFile);

Följande bild visar de uppdaterade dokumentegenskaperna.

Changed document properties of the PowerPoint presentation

Användbara länkar

För relaterade säkerhetskontroller och skyddsinställningar, se följande artiklar:

FAQ

Hur kan jag kontrollera om teckensnitt är inbäddade och vilka de är?

Ladda presentationen och använd Presentation::get_FontsManager. Anropa FontsManager::GetEmbeddedFonts för att hämta de inbäddade teckensnitten och FontsManager::GetFonts för att hämta de teckensnitt som används i presentationen. Jämför de två resultaten för att hitta teckensnitt som krävs för rendering men som inte är inbäddade.

Hur kan jag snabbt avgöra om filen har dolda slides och hur många?

När lagrad dokumentmetadata är tillräcklig, läs IDocumentProperties::get_HiddenSlides via IPresentationFactory::GetPresentationInfo och IPresentationInfo::ReadDocumentProperties. Detta är lämpligt för ett lättviktigt register. Om presentationen har modifierats i minnet kan den lagrade metadata saknas eller vara föråldrad, eller så behöver du verifiera aktuella värden; iterera då genom Presentation::get_Slides och inspektera varje slides Slide::get_Hidden‑metod istället.

Kan jag upptäcka om en anpassad bildstorlek och -orientering används, och om de avviker från standarderna?

Ja. Ladda presentationen och läs Presentation::get_SlideSize. Inspektera ISlideSize::get_Type, ISlideSize::get_Size och ISlideSize::get_Orientation för att jämföra de aktuella inställningarna med den förväntade förinställningen och dimensionerna.

Finns det ett snabbt sätt att se om diagram refererar till externa datakällor?

Ja. Hitta varje Chart och inspektera ChartData::get_DataSourceType. För en extern arbetsbok, läs ChartData::get_ExternalWorkbookPath. Datakälltypen och sökvägen identifierar en extern referens, men att verifiera om målet är tillgängligt kräver en separat resurssökning.

Hur kan jag bedöma ‘tunga’ slides som kan sakta ner rendering eller PDF-export?

Det finns ingen enskild komplexitetsegenskap. Traversera Presentation::get_Slides och varje slides IBaseSlide::get_Shapes‑samling. Använd antal former och förekomsten av stora bilder, effekter, animationer eller multimedia som screeningssignaler, och mät en representativ rendering eller export innan du behandlar en slide som en bekräftad prestandaflaskhals.

Öppna presentationer i C++ Bestäm det ursprungliga presentationsformatet i C++