Presentatie-informatie ophalen en bijwerken in C++

Waar deze pagina over gaat

Ontdek dia’s, structuur en metadata in PowerPoint‑ en OpenDocument‑presentaties met C++ voor snellere inzichten en slimmere inhoudsaudits.

Overzicht

Aspose.Slides kan het formaat van een presentatie identificeren en de document‑metadata lezen zonder een volledig presentatiemodel te maken. Dit is nuttig wanneer u bestanden moet classificeren, een inventaris wilt opbouwen of eigenschappen wilt inspecteren voordat u beslist of de presentatie‑inhoud moet worden geladen en verwerkt.

Dit artikel toont lichte inspectie via PresentationFactory en IPresentationInfo, evenals gerichte updates via IDocumentProperties.

Controleer een presentatie‑indeling

Als u al een geladen presentatie hebt, zie Determine the Original Presentation Format voor detectie na het laden en de beperkingen van legacy‑PPT, PPS en POT‑stromen.

Gebruik IPresentationFactory::GetPresentationInfo om een bestand te inspecteren zonder een Presentation‑instance te creëren. De methode IPresentationInfo::get_LoadFormat rapporteert het gedetecteerde formaat, zoals PPTX, PPT of 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())));
}

Bouw een lichte presentaties‑inventaris

Wanneer u veel presentatiebestanden verwerkt, heeft u mogelijk een compacte inventaris nodig voor validatie, indexering of een document‑beheersysteem. Gebruik in dit scenario IPresentationFactory::GetPresentationInfo om een IPresentationInfo‑object te verkrijgen, en roep vervolgens IPresentationInfo::ReadDocumentProperties aan om de document‑metadata te lezen. Deze aanpak maakt geen Presentation‑instance aan en vereist niet dat u het volledige presentatiemodel doorloopt.

De uitgebreide eigenschappen die door IDocumentProperties worden blootgesteld, leveren de volgende inventariswaarden:

Methode	Inventariswaarde
get_Slides	Totaal aantal dia’s.
get_HiddenSlides	Aantal verborgen dia’s.
get_Notes	Aantal dia’s met notities.
get_Paragraphs	Totaal aantal alinea’s, wanneer beschikbaar.
get_Words	Totaal aantal woorden.
get_MultimediaClips	Totaal aantal audio‑ en video‑clips.

Het volgende voorbeeld leest deze waarden zonder een Presentation‑object te maken en print een compacte inventaris. Het combineert bovendien IDocumentProperties::get_HeadingPairs met IDocumentProperties::get_TitlesOfParts om inhoudsgroepen weer te geven, zoals lettertypen, thema’s en dia‑titels.

#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++;
        }
    }
}

Elke IHeadingPair levert een groepsnaam via IHeadingPair::get_Name en het aantal items in die groep via IHeadingPair::get_Count. IDocumentProperties::get_TitlesOfParts retourneert een platte, geordende array, zodat u het aantal opeenvolgende titels kunt verwerken dat door elk heading‑pair wordt gespecificeerd.

Opgeslagen metadata en formatbeperkingen

De inventariseereigenschappen die door IPresentationInfo::ReadDocumentProperties worden geretourneerd, weerspiegelen de metadata die beschikbaar is in het bron‑document. Aspose.Slides laadt en doorloopt het presentatiemodel niet om deze waarden opnieuw te berekenen voor deze oproep. Ontbrekende eigenschappen worden weergegeven met standaardwaarden, en opgeslagen waarden kunnen verouderd zijn als de applicatie die het bestand het laatst heeft opgeslagen, de documenteigenschappen niet heeft bijgewerkt.

PPTX: Het formaat biedt uitgebreide documenteigenschappen voor dia‑, notitie‑, verborgen‑dia‑, alinea‑, woord‑ en multimedia‑telling, evenals heading‑pairs en part‑titles. Beschikbaarheid hangt af van welke eigenschappen door de documentproducer zijn weggeschreven.
PPT: Het binaire formaat kan overeenkomstige document‑samenvattings‑eigenschappen opslaan. Als een eigenschap afwezig is of niet is ververst door de documentproducer, retourneert Aspose.Slides de opgeslagen of standaardwaarde in plaats van deze te berekenen uit de dia’s.
ODP: OpenDocument‑metadata biedt algemene documentstatistieken, zoals pagina‑, alinea‑ en woordtelling, maar deze waarden corresponderen niet met elke PowerPoint‑specifieke uitgebreide eigenschap. Metadata voor verborgen dia’s, notities, multimedia, heading‑pairs en part‑titles kan ontbreken, en de inventariseereigenschappen kunnen standaardwaarden retourneren. Beschouw een nulwaarde of een lege array niet als sluitend bewijs dat de overeenkomstige inhoud ontbreekt.

Gebruik de lichte metadata‑aanpak voor inventarissen en voorlopige controles. Laad de presentatie en inspecteer het live‑objectmodel wanneer het resultaat moet weerspiegelen dat er in‑memory wijzigingen zijn aangebracht of wanneer u de feitelijke presentatiewaarde moet verifiëren.

Werk presentatie‑eigenschappen bij

De eigenschappen die door IPresentationInfo::ReadDocumentProperties worden geretourneerd, kunnen ook worden gewijzigd zonder een Presentation‑instance te maken. Pas de wijzigingen toe met IPresentationInfo::UpdateDocumentProperties, en schrijf vervolgens de gekoppelde presentatie met IPresentationInfo::WriteBindedPresentation.

De volgende afbeelding toont de oorspronkelijke documenteigenschappen.

Oorspronkelijke documenteigenschappen van de PowerPoint-presentatie

Het volgende voorbeeld wijzigt de titel en de laatst‑opgeslagen tijd en schrijft het resultaat naar een nieuw bestand:

#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);

De volgende afbeelding toont de bijgewerkte documenteigenschappen.

Gewijzigde documenteigenschappen van de PowerPoint-presentatie

Handige links

Voor gerelateerde beveiligingscontroles en beschermingsinstellingen, zie de volgende artikelen:

FAQ

Hoe kan ik controleren of lettertypen zijn ingebed en welke dat zijn?

Laad de presentatie en gebruik Presentation::get_FontsManager. Roep FontsManager::GetEmbeddedFonts aan om de ingebedde lettertypen te verkrijgen en FontsManager::GetFonts om de door de presentatie gebruikte lettertypen te verkrijgen. Vergelijk beide resultaten om de lettertypen te vinden die vereist zijn voor weergave maar niet zijn ingebed.

Hoe kan ik snel zien of het bestand verborgen dia’s bevat en hoeveel?

Wanneer opgeslagen documentmetadata voldoende is, lees IDocumentProperties::get_HiddenSlides via IPresentationFactory::GetPresentationInfo en IPresentationInfo::ReadDocumentProperties. Dit is geschikt voor een lichte inventaris. Heeft de presentatie in‑memory wijzigingen ondergaan, kunnen de opgeslagen metadata ontbreken of verouderd zijn, of moet u live‑waardes verifiëren; iterate dan door Presentation::get_Slides en inspecteer de Slide::get_Hidden‑methode van elke dia.

Kan ik detecteren of een aangepaste dia‑grootte en -oriëntatie wordt gebruikt, en of die afwijkt van de standaardinstellingen?

Ja. Laad de presentatie en lees Presentation::get_SlideSize. Inspecteer ISlideSize::get_Type, ISlideSize::get_Size en ISlideSize::get_Orientation om de huidige instellingen te vergelijken met de verwachte standaard en afmetingen.

Is er een snelle manier om te zien of grafieken naar externe gegevensbronnen verwijzen?

Ja. Zoek elke Chart en inspecteer ChartData::get_DataSourceType. Voor een extern werkblad, lees ChartData::get_ExternalWorkbookPath. Het type gegevensbron en het pad identificeren een externe verwijzing, maar verifiëren of het doel beschikbaar is vereist een aparte resource‑check.

Hoe kan ik ‘zware’ dia’s beoordelen die het renderen of PDF‑export kunnen vertragen?

Er bestaat geen enkele complexiteits‑eigenschap. Doorloop Presentation::get_Slides en voor elke dia de collectie IBaseSlide::get_Shapes. Gebruik het aantal vormen en de aanwezigheid van grote afbeeldingen, effecten, animaties of multimedia‑objecten als screeningssignalen, en meet een representatieve render‑ of export‑tijd voordat u een dia als bevestigd prestatie‑knelpunt beschouwt.

Presentaties openen in C++ Bepaal het originele presentatieformaat in C++