Gestire le proprietà della presentazione in C++

Introduzione

Aspose.Slides per C++ supporta le proprietà dei documenti integrate e personalizzate. Utilizza queste proprietà per leggere e aggiornare i metadati della presentazione, come l’autore, il titolo e i valori definiti dall’utente.

Aspose.Slides consente di lavorare con le proprietà dei documenti della presentazione tramite l’interfaccia IDocumentProperties . Un’istanza di questa interfaccia viene restituita da IPresentation::get_DocumentProperties. I seguenti esempi mostrano come leggere, modificare e gestire queste proprietà.

Gestire le proprietà della presentazione

Le proprietà del documento memorizzano informazioni descrittive insieme al contenuto della presentazione. Si suddividono in due categorie:

  • Proprietà integrate contengono metadati standard, come il titolo, l’autore e le statistiche del documento.
  • Proprietà personalizzate memorizzano coppie nome/valore definite dall’utente.

Aspose.Slides per C++ fornisce l’accesso a entrambe le categorie. In PowerPoint, seleziona File → Info → Properties → Advanced Properties per ispezionare i metadati del documento. La finestra raggruppa le informazioni in schede come Summary, Statistics, Contents e Custom. Usa la scheda Custom per gestire le proprietà definite dall’utente.

Leggere le proprietà pubbliche da una presentazione crittografata

Una password di apertura normalmente protegge sia il contenuto della presentazione sia le proprietà del documento. Quando una presentazione viene crittografata passando false a IProtectionManager::set_EncryptDocumentProperties, le sue proprietà del documento rimangono pubbliche. Un’applicazione può quindi passare true a LoadOptions::set_OnlyLoadDocumentProperties e leggere i metadati pubblici senza fornire la password di apertura.

LoadOptions::set_OnlyLoadDocumentProperties controlla cosa carica Aspose.Slides; non decritta nulla. Se le proprietà erano incluse nella crittografia, il loro caricamento senza la password fallisce. Se la presentazione non è crittografata, l’opzione viene ignorata e viene caricata l’intera presentazione.

L’esempio richiede una presentazione crittografata le cui proprietà del documento sono state lasciate pubbliche. Verifica la modalità di caricamento tramite IProtectionManager::get_IsOnlyDocumentPropertiesLoaded, quindi legge le proprietà integrate tramite IPresentation::get_DocumentProperties:

#include <DOM/IDocumentProperties.h>
#include <DOM/Presentation.h>
#include <system/console.h>
#include <DOM/LoadOptions.h>
#include <DOM/IProtectionManager.h>

using namespace Aspose::Slides;

auto loadOptions = System::MakeObject<LoadOptions>();
loadOptions->set_OnlyLoadDocumentProperties(true);

auto presentation = System::MakeObject<Presentation>(u"public-properties-encrypted.pptx", loadOptions);

if (presentation->get_ProtectionManager()->get_IsOnlyDocumentPropertiesLoaded())
{
    auto documentProperties = presentation->get_DocumentProperties();

    System::Console::WriteLine(u"Author: {0}", documentProperties->get_Author());
    System::Console::WriteLine(u"Title: {0}", documentProperties->get_Title());
    System::Console::WriteLine(u"Keywords: {0}", documentProperties->get_Keywords());
}
else
{
    System::Console::WriteLine(u"The presentation was not loaded in document-properties-only mode.");
}

In questa modalità, il contenuto delle diapositive non viene caricato. Diapositive, master, layout, forme, media e altri oggetti della presentazione non sono disponibili. Le applicazioni dovrebbero sempre verificare IProtectionManager::get_IsOnlyDocumentPropertiesLoaded prima di eseguire un’operazione che richiede il modello di oggetti completo della presentazione.

Aggiornare le proprietà di una presentazione crittografata

Per un file PPTX crittografato, una presentazione caricata passando true a LoadOptions::set_OnlyLoadDocumentProperties è destinata alla lettura dei metadati pubblici. Aspose.Slides non può salvare le proprietà modificate da quell’oggetto solo metadati perché le proprietà pubbliche devono rimanere coerenti con i dati corrispondenti all’interno della presentazione crittografata. Aggiornare tali proprietà richiede quindi la password di apertura corretta e un caricamento completo.

L’esempio richiede una presentazione PPTX crittografata con proprietà del documento pubbliche e una password di apertura nota. Apre l’intera presentazione con LoadOptions::set_Password, aggiorna le proprietà integrate pubbliche e salva il risultato. Quindi utilizza IPresentationInfo::get_IsEncrypted per verificare che la crittografia sia mantenuta e riapre i metadati pubblici senza password per verificare i nuovi valori:

#include <DOM/IDocumentProperties.h>
#include <DOM/Presentation.h>
#include <system/console.h>
#include <DOM/LoadOptions.h>
#include <DOM/IProtectionManager.h>
#include <DOM/PresentationFactory.h>
#include <DOM/IPresentationInfo.h>
#include <Export/SaveFormat.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;

const System::String inputPath = u"public-properties-encrypted.pptx";
const System::String outputPath = u"updated-public-properties-encrypted.pptx";

auto loadOptions = System::MakeObject<LoadOptions>();
loadOptions->set_Password(u"open_password");

auto presentation = System::MakeObject<Presentation>(inputPath, loadOptions);

auto documentProperties = presentation->get_DocumentProperties();
documentProperties->set_Title(u"Updated Product Roadmap");
documentProperties->set_Keywords(u"roadmap, planning, indexed");

presentation->Save(outputPath, SaveFormat::Pptx);

auto presentationInfo = PresentationFactory::get_Instance()->GetPresentationInfo(outputPath);
System::Console::WriteLine(u"The presentation is encrypted: {0}", presentationInfo->get_IsEncrypted());

auto metadataLoadOptions = System::MakeObject<LoadOptions>();
metadataLoadOptions->set_OnlyLoadDocumentProperties(true);

auto metadataPresentation = System::MakeObject<Presentation>(outputPath, metadataLoadOptions);

if (metadataPresentation->get_ProtectionManager()->get_IsOnlyDocumentPropertiesLoaded())
{
    System::Console::WriteLine(u"Title: {0}", metadataPresentation->get_DocumentProperties()->get_Title());
    System::Console::WriteLine(u"Keywords: {0}", metadataPresentation->get_DocumentProperties()->get_Keywords());
}
else
{
    System::Console::WriteLine(u"The presentation was not loaded in document-properties-only mode.");
}

Se un’applicazione non è autorizzata a decrittare o caricare il contenuto della presentazione, deve trattare le proprietà pubbliche di un file PPTX crittografato come sola lettura.

Accedere alle proprietà integrate

L’interfaccia IDocumentProperties espone i metadati integrati tramite getter tipizzati, inclusi get_Author, get_Title, e get_CreatedTime. Questo esempio apre una presentazione esistente e stampa i metadati memorizzati sulla console. I valori dipendono dalla presentazione di input; alcuni campi potrebbero essere vuoti.

#include <DOM/IDocumentProperties.h>
#include <DOM/Presentation.h>
#include <system/console.h>

using namespace Aspose::Slides;

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

auto documentProperties = presentation->get_DocumentProperties();

System::Console::WriteLine(u"Category: {0}", documentProperties->get_Category());
System::Console::WriteLine(u"Content status: {0}", documentProperties->get_ContentStatus());
System::Console::WriteLine(u"Creation date: {0}", documentProperties->get_CreatedTime());
System::Console::WriteLine(u"Author: {0}", documentProperties->get_Author());
System::Console::WriteLine(u"Comments: {0}", documentProperties->get_Comments());
System::Console::WriteLine(u"Keywords: {0}", documentProperties->get_Keywords());
System::Console::WriteLine(u"Last modified by: {0}", documentProperties->get_LastSavedBy());
System::Console::WriteLine(u"Manager: {0}", documentProperties->get_Manager());
System::Console::WriteLine(u"Modified date: {0}", documentProperties->get_LastSavedTime());
System::Console::WriteLine(u"Presentation format: {0}", documentProperties->get_PresentationFormat());
System::Console::WriteLine(u"Last print date: {0}", documentProperties->get_LastPrinted());
System::Console::WriteLine(u"Is shared between producers: {0}", documentProperties->get_SharedDoc());
System::Console::WriteLine(u"Subject: {0}", documentProperties->get_Subject());
System::Console::WriteLine(u"Title: {0}", documentProperties->get_Title());

Modificare le proprietà integrate

Per aggiornare i metadati integrati, utilizza i metodi setter sull’oggetto restituito da IPresentation::get_DocumentProperties. Questo esempio apre una presentazione esistente, chiama set_Author, set_Title, set_Subject, set_Comments, e set_Manager, quindi salva la presentazione aggiornata con Presentation::Save. Il PPTX salvato contiene i nuovi metadati.

#include <DOM/IDocumentProperties.h>
#include <DOM/Presentation.h>
#include <system/console.h>
#include <Export/SaveFormat.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;

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

auto documentProperties = presentation->get_DocumentProperties();

documentProperties->set_Author(u"Aspose.Slides for C++");
documentProperties->set_Title(u"Manage PowerPoint Presentation Properties");
documentProperties->set_Subject(u"Modify Built-in Properties");
documentProperties->set_Comments(u"Aspose description");
documentProperties->set_Manager(u"Aspose manager");

presentation->Save(u"DocumentProperties_output.pptx", SaveFormat::Pptx);

Gestire la base dei collegamenti ipertestuali

IDocumentProperties::get_HyperlinkBase legge la base a livello di documento per i collegamenti ipertestuali relativi. Questo è utile quando si sposta una presentazione e i suoi file collegati in un’altra posizione. È separato dall'IHyperlink::get_ExternalUrl di un singolo collegamento: modificare la base non riscrive gli indirizzi dei collegamenti memorizzati né cambia le destinazioni assolute.

L’esempio richiede una presentazione contenente sia un collegamento relativo, come target.html, sia un collegamento assoluto, come https://example.org/absolute.html. Legge la base esistente, assegna un nuovo indirizzo base con IDocumentProperties::set_HyperlinkBase, quindi salva e riapre la presentazione per verificare il valore. Successivamente cancella la base con u"" e verifica il valore vuoto in un file salvato separato. Sostituisci l’indirizzo base dell’esempio con la posizione dei tuoi file collegati.

#include <DOM/IDocumentProperties.h>
#include <DOM/Presentation.h>
#include <system/console.h>
#include <Export/SaveFormat.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;

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

System::Console::WriteLine(u"Original base: {0}", presentation->get_DocumentProperties()->get_HyperlinkBase());

const System::String newBase = u"https://example.com/new/";
presentation->get_DocumentProperties()->set_HyperlinkBase(newBase);
presentation->Save(u"hyperlinks-updated.pptx", SaveFormat::Pptx);

auto updatedPresentation = System::MakeObject<Presentation>(u"hyperlinks-updated.pptx");
System::Console::WriteLine(u"Base preserved: {0}", (updatedPresentation->get_DocumentProperties()->get_HyperlinkBase() == newBase));

updatedPresentation->get_DocumentProperties()->set_HyperlinkBase(u"");
updatedPresentation->Save(u"hyperlinks-cleared.pptx", SaveFormat::Pptx);

auto clearedPresentation = System::MakeObject<Presentation>(u"hyperlinks-cleared.pptx");
System::Console::WriteLine(u"Base cleared: {0}", (clearedPresentation->get_DocumentProperties()->get_HyperlinkBase() == u""));

I due messaggi di verifica dovrebbero stampare True. La cancellazione della base lascia intatti gli indirizzi dei collegamenti ipertestuali individuali.

Un collegamento relativo a target.pptx apriva old/target.pptx quando la base puntava alla cartella old. Dopo aver cambiato la base alla cartella new, salvato e riaperto la presentazione, lo stesso collegamento apriva new/target.pptx. Un collegamento assoluto ha continuato ad aprire lo stesso file. Prova i tuoi collegamenti relativi in PowerPoint prima e dopo aver spostato la presentazione o cambiato la sua base.

Aggiungere proprietà personalizzate della presentazione

Le proprietà personalizzate memorizzano metadati che non hanno un campo integrato corrispondente. IDocumentProperties::idx_set consente di assegnare un valore tramite il nome della proprietà. Questo esempio crea una presentazione, aggiunge due valori di testo e un valore di versione intero, e salva la presentazione con Presentation::Save. Assegnare un valore a un nome esistente sostituisce il valore di quella proprietà.

#include <DOM/IDocumentProperties.h>
#include <DOM/Presentation.h>
#include <system/console.h>
#include <Export/SaveFormat.h>
#include <system/object_ext.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;

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

auto documentProperties = presentation->get_DocumentProperties();

documentProperties->idx_set(u"Reviewed by", System::ObjectExt::Box<System::String>(u"John Smith"));
documentProperties->idx_set(u"Confidentiality level", System::ObjectExt::Box<System::String>(u"Internal"));
documentProperties->idx_set(u"Document version", System::ObjectExt::Box(2));

presentation->Save(u"CustomDocumentProperties_output.pptx", SaveFormat::Pptx);

Accedere e modificare le proprietà personalizzate

Questo esempio apre una presentazione contenente proprietà personalizzate e utilizza get_CountOfCustomProperties per iterarle. GetCustomPropertyName accetta un indice a base zero e restituisce il nome usato da IDocumentProperties::idx_get e idx_set. L’esempio stampa ogni nome e valore originale, sostituisce ogni valore con una stringa numerata indipendentemente dal tipo originale, e salva le modifiche. Se non ci sono proprietà personalizzate, il ciclo non apporta modifiche.

#include <DOM/IDocumentProperties.h>
#include <DOM/Presentation.h>
#include <system/console.h>
#include <Export/SaveFormat.h>
#include <system/object_ext.h>

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;

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

auto documentProperties = presentation->get_DocumentProperties();

for (auto i = 0; i < documentProperties->get_CountOfCustomProperties(); i++)
{
    auto propertyName = documentProperties->GetCustomPropertyName(i);
    auto propertyValue = documentProperties->idx_get(propertyName);

    System::Console::WriteLine(u"Custom property name: {0}", propertyName);
    System::Console::WriteLine(u"Custom property value: {0}", propertyValue);

    documentProperties->idx_set(propertyName, System::ObjectExt::Box(System::String::Format(u"New Value {0}", i + 1)));
}

presentation->Save(u"CustomProperties_output.pptx", SaveFormat::Pptx);

Esempio live

Prova l’app online View & Edit PowerPoint Metadata per vedere come lavorare con le proprietà dei documenti usando l’API Aspose.Slides:

View & Edit PowerPoint Metadata

FAQ

Come posso rimuovere una proprietà integrata da una presentazione?

Le proprietà integrate sono una parte integrante della presentazione e non possono essere rimosse completamente. Tuttavia, è possibile modificarne i valori o impostarle a vuoto se consentito dalla proprietà specifica.

Cosa succede se aggiungo una proprietà personalizzata che esiste già?

Se aggiungi una proprietà personalizzata che esiste già, il suo valore esistente verrà sovrascritto con quello nuovo. Non è necessario rimuovere o verificare la proprietà in anticipo, poiché Aspose.Slides aggiorna automaticamente il valore della proprietà.

Posso accedere alle proprietà della presentazione senza caricare completamente la presentazione?

Sì. Usa PresentationFactory::GetPresentationInfo e poi IPresentationInfo::ReadDocumentProperties per leggere i metadati del documento memorizzati senza creare un’istanza di Presentation. Vedi Build a Lightweight Presentation Inventory per un esempio completo di reporting e le limitazioni specifiche del formato.

Posso leggere le proprietà pubbliche di una presentazione crittografata senza la sua password di apertura?

Sì. La presentazione deve essere stata crittografata passando false a IProtectionManager::set_EncryptDocumentProperties, e deve essere caricata passando true a LoadOptions::set_OnlyLoadDocumentProperties.

Posso aggiornare un file PPTX crittografato in modalità solo proprietà del documento?

No. I dati delle proprietà pubbliche e crittografate devono rimanere coerenti, quindi aggiornare un file PPTX crittografato richiede il caricamento dell’intera presentazione con la password di apertura corretta.