Unire presentazioni in modo efficiente in C++

Di cosa tratta questa pagina

Scopri come unire presentazioni PowerPoint e OpenDocument in C++ clonando le diapositive, controllando i master e i layout, ridimensionando il contenuto delle diapositive, preservando le sezioni e gestendo file protetti o di grandi dimensioni.

Panoramica

Aspose.Slides per C++ unisce le presentazioni clonando le diapositive da una Presentation a un’altra. L’operazione principale è ISlideCollection::AddClone, che può preservare la formattazione della diapositiva di origine o allegare la diapositiva clonata a un master o a un layout nella presentazione di destinazione.

Questo articolo copre i flussi di lavoro di unione più comuni:

unire tutte le diapositive preservando la formattazione di origine;
unire diapositive selezionate;
applicare un master dalla presentazione di destinazione;
applicare un layout specifico dalla presentazione di destinazione;
normalizzare diverse dimensioni di diapositiva prima dell’unione;
aggiungere diapositive clonate a una sezione;
unire più presentazioni in un unico flusso di lavoro end‑to‑end;
gestire master, risorse, note, commenti, media, caratteri, password, file di grandi dimensioni e considerazioni sul multithreading.

Come la clonazione delle diapositive influisce su master e layout

Una diapositiva eredita gran parte del suo aspetto dal layout e dal master. Per questo motivo, la sovraccarico di clonazione che scegli determina come la diapositiva unita viene integrata nella presentazione di destinazione.

Usa ISlideCollection::AddClone in uno dei seguenti modi:

AddClone(sourceSlide) — preserva il layout e la formattazione della diapositiva di origine. Quando necessario, il master di origine può essere clonato automaticamente nella presentazione di destinazione. Aspose.Slides tiene traccia dei master clonate automaticamente in modo che le diapositive ripetute che usano lo stesso master di origine non provocino la clonazione ripetuta di quel master.
AddClone(sourceSlide, destinationMaster, allowCloneMissingLayout) — allega la diapositiva clonata a uno specifico IMasterSlide di destinazione. Aspose.Slides cerca un layout corrispondente sotto quel master per tipo di layout o nome.
AddClone(sourceSlide, destinationLayout) — allega la diapositiva clonata direttamente a uno specifico ILayoutSlide di destinazione.

Il master o il layout passati a una sovraccarico AddClone devono appartenere alla presentazione di destinazione, non a quella di origine.

Unire intere presentazioni preservando la formattazione di origine

L’unione più semplice copia ogni diapositiva dalla presentazione di origine alla presentazione di destinazione. Questa è la scelta appropriata quando le diapositive importate devono mantenere il tema, il master e le relazioni di layout originali.

#include <DOM/ISlideCollection.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>

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

auto destination = System::MakeObject<Presentation>(u"destination.pptx");
auto source = System::MakeObject<Presentation>(u"source.pptx");

for (const auto& slide : source->get_Slides())
{
    destination->get_Slides()->AddClone(slide);
}

destination->Save(u"merged.pptx", SaveFormat::Pptx);

La presentazione risultante può contenere più master quando l’origine e la destinazione utilizzano design diversi. Questo è previsto quando la formattazione di origine viene preservata intenzionalmente.

Unire diapositive selezionate

Non è necessario clonare tutte le diapositive. L’esempio seguente importa solo gli indici di diapositiva selezionati dalla presentazione di origine.

#include <DOM/ISlideCollection.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>

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

auto destination = System::MakeObject<Presentation>(u"destination.pptx");
auto source = System::MakeObject<Presentation>(u"source.pptx");

int32_t slideIndexes[] = {0, 2, 4};

for (auto index : slideIndexes)
{
    destination->get_Slides()->AddClone(source->get_Slide(index));
}

destination->Save(u"merged-selected-slides.pptx", SaveFormat::Pptx);

Convalida gli indici di diapositiva prima di clonare quando provengono da input dell’utente o da configurazioni esterne.

Unire diapositive usando un master di destinazione

Usa la sovraccarico AddClone(ISlide, IMasterSlide, bool) quando le diapositive importate devono seguire un master che già appartiene alla presentazione di destinazione.

#include <DOM/IMasterSlide.h>
#include <DOM/ISlideCollection.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>

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

auto destination = System::MakeObject<Presentation>(u"destination.pptx");
auto source = System::MakeObject<Presentation>(u"source.pptx");

auto destinationMaster = destination->get_Master(0);

for (const auto& slide : source->get_Slides())
{
    destination->get_Slides()->AddClone(slide, destinationMaster, true);
}

destination->Save(u"merged-with-destination-master.pptx", SaveFormat::Pptx);

Aspose.Slides seleziona un layout appropriato sotto il master specificato corrispondendo al tipo o al nome del layout di origine. Se non esiste un layout adatto e allowCloneMissingLayout è true, il layout di origine viene clonato così la diapositiva può essere aggiunta. Se è false, viene generata un'PptxEditException.

Usa false quando vuoi che l’unione fallisca invece di introdurre un layout aggiuntivo nel master di destinazione.

Unire diapositive usando un layout di destinazione specifico

Usa la sovraccarico AddClone(ISlide, ILayoutSlide) quando conosci esattamente quale layout di destinazione devono usare le diapositive importate.

#include <DOM/ILayoutSlide.h>
#include <DOM/ISlideCollection.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>

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

auto destination = System::MakeObject<Presentation>(u"destination.pptx");
auto source = System::MakeObject<Presentation>(u"source.pptx");

auto destinationLayout = destination->get_LayoutSlide(0);

for (const auto& slide : source->get_Slides())
{
    destination->get_Slides()->AddClone(slide, destinationLayout);
}

destination->Save(u"merged-with-destination-layout.pptx", SaveFormat::Pptx);

L’applicazione di un layout di destinazione modifica la relazione di layout ereditata; non ridisegna il contenuto della diapositiva di origine. Se i layout di origine e destinazione hanno strutture di segnaposto diverse, ispeziona il risultato per confermare che la formattazione ereditata e il comportamento dei segnaposto siano appropriati.

Unire presentazioni con dimensioni di diapositiva diverse

Le presentazioni con dimensioni di diapositiva diverse possono essere unite, ma clonare una diapositiva in una presentazione con un’altra dimensione non ridisegna automaticamente il suo contenuto per la nuova tela. Le forme possono quindi apparire spostate, scalate in modo inatteso o fuori dall’area visibile della diapositiva.

Un approccio pratico è ridimensionare la presentazione di origine prima di clonare. Il metodo SlideSize::SetSize può scalare il contenuto esistente modificando le dimensioni della diapositiva. SlideSizeScaleType::EnsureFit scala il contenuto per adattarlo alla dimensione richiesta.

#include <DOM/ISlideCollection.h>
#include <DOM/ISlideSize.h>
#include <DOM/Presentation.h>
#include <DOM/SlideSizeScaleType.h>
#include <Export/SaveFormat.h>
#include <drawing/size_f.h>

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

auto destination = System::MakeObject<Presentation>(u"destination.pptx");
auto source = System::MakeObject<Presentation>(u"source.pptx");

auto destinationSize = destination->get_SlideSize()->get_Size();
auto sourceSize = source->get_SlideSize()->get_Size();

if (sourceSize.get_Width() != destinationSize.get_Width() || 
    sourceSize.get_Height() != destinationSize.get_Height())
{
    source->get_SlideSize()->SetSize(
        destinationSize.get_Width(), 
        destinationSize.get_Height(), 
        SlideSizeScaleType::EnsureFit);
}

for (const auto& slide : source->get_Slides())
{
    destination->get_Slides()->AddClone(slide);
}

destination->Save(u"merged-same-slide-size.pptx", SaveFormat::Pptx);

Il ridimensionamento modifica l’oggetto della presentazione di origine in memoria. Se hai bisogno che la presentazione di origine originale rimanga invariata per altre operazioni, apri un’istanza separata per l’unione.

Unire diapositive in una sezione della presentazione

Il ciclo di base per la clonazione delle diapositive non ricrea la gerarchia delle sezioni della presentazione di origine. Se le sezioni sono importanti nell’output, crea o seleziona le sezioni nella presentazione di destinazione e clona le diapositive in esse esplicitamente con AddClone(ISlide, ISection).

#include <DOM/ISectionCollection.h>
#include <DOM/ISlideCollection.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>

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

auto destination = System::MakeObject<Presentation>(u"destination.pptx");
auto source = System::MakeObject<Presentation>(u"source.pptx");

auto importedSection = destination->get_Sections()->AppendEmptySection(u"Imported slides");

for (const auto& slide : source->get_Slides())
{
    destination->get_Slides()->AddClone(slide, importedSection);
}

destination->Save(u"merged-with-section.pptx", SaveFormat::Pptx);

Le diapositive clonate vengono aggiunte alla sezione di destinazione specificata. Per preservare più sezioni di origine, elenca le Presentation::get_Sections, recupera le diapositive correnti di ciascuna sezione di origine con ISection::GetSlidesListOfSection, ricrea le sezioni nella destinazione e clona ogni diapositiva restituita nella sua corrispondente sezione di destinazione. Vedi Manage Slide Sections per un esempio completo di enumerazione delle sezioni, incluse sezioni vuote e modifiche strutturali.

Unire più presentazioni in modo sicuro

L’esempio end‑to‑end seguente usa la prima presentazione come destinazione, normalizza la dimensione della diapositiva di ciascuna origine aggiuntiva, mantiene ogni origine aperta solo mentre viene copiata e salva il file finale una sola volta.

#include <DOM/ISlideCollection.h>
#include <DOM/ISlideSize.h>
#include <DOM/Presentation.h>
#include <DOM/SlideSizeScaleType.h>
#include <Export/SaveFormat.h>
#include <drawing/size_f.h>

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

System::String inputFiles[] = {u"part1.pptx", u"part2.pptx", u"part3.pptx"};
const int32_t inputFileCount = 3;

auto merged = System::MakeObject<Presentation>(inputFiles[0]);
auto mergedSize = merged->get_SlideSize()->get_Size();

for (int32_t fileIndex = 1; fileIndex < inputFileCount; fileIndex++)
{
    auto source = System::MakeObject<Presentation>(inputFiles[fileIndex]);
    auto sourceSize = source->get_SlideSize()->get_Size();

    if (sourceSize.get_Width() != mergedSize.get_Width() || 
        sourceSize.get_Height() != mergedSize.get_Height())
    {
        source->get_SlideSize()->SetSize(
            mergedSize.get_Width(), 
            mergedSize.get_Height(), 
            SlideSizeScaleType::EnsureFit);
    }

    for (const auto& slide : source->get_Slides())
    {
        merged->get_Slides()->AddClone(slide);
    }
}

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

Questo è un utile punto di partenza per preservare la formattazione di origine delle diapositive importate. Se il risultato deve utilizzare un unico tema di destinazione, sostituisci la semplice chiamata AddClone(slide) con la sovraccarico di master o layout di destinazione appropriata mostrata in precedenza.

Considerazioni pratiche

Master, layout e fedeltà della formattazione

La clonazione predefinita delle diapositive può inserire automaticamente un master di origine necessario nella presentazione di destinazione. Aspose.Slides mantiene un registro interno per i master clonati automaticamente per evitare di clonare lo stesso master più volte. I master clonati manualmente non sono tracciati da quel registro, quindi evita di pre‑clonare i master a meno che non ti serva un controllo esplicito sulla struttura del master.

Non presumere che due master o layout con lo stesso nome siano visivamente equivalenti. Se un modello aziendale deve controllare l’aspetto finale, scegli esplicitamente un master o un layout di destinazione e verifica il risultato dopo l’unione.

Note e commenti

Le note del relatore e i commenti delle diapositive sono associati al contenuto della diapositiva e vengono copiati quando una diapositiva è clonata. Aspose.Slides espone anche API dedicate per presentation notes e presentation comments.

Se la formattazione della pagina delle note è importante, verifica la presentazione unita perché i master delle note sono oggetti a livello di presentazione e possono differire tra i file di origine. Per i flussi di revisione, verifica anche gli autori dei commenti e i commenti in thread dopo aver combinato file da autori o modelli diversi.

Immagini, audio, video, oggetti OLE e collegamenti esterni

Le diapositive possono fare riferimento a risorse a livello di presentazione come immagini, audio incorporato, video incorporato e dati OLE. Clona la diapositiva stessa anziché copiare solo le forme visibili affinché Aspose.Slides possa mantenere le relazioni della diapositiva con le sue risorse.

Le risorse incorporate e collegate devono essere trattate diversamente. Un audio, video, oggetto OLE o collegamento ipertestuale collegato rimane dipendente dal suo target esterno; clonare una diapositiva non trasforma un collegamento esterno in contenuto incorporato. Testa i percorsi e gli URL delle risorse collegate nell’ambiente in cui la presentazione unita sarà aperta.

Aspose.Slides tiene traccia esplicitamente dei master clonati automaticamente, ma ciò non deve essere considerato una garanzia generale che risorse binarie identiche da presentazioni di origine non correlate vengano sempre deduplicate. Se la dimensione del file di output è importante, ispeziona il pacchetto unito e misura il risultato invece di fare affidamento sulla deduplicazione implicita.

Caratteri incorporati e disponibilità dei caratteri

I caratteri sono gestiti a livello di presentazione. Se la tipografia deve rimanere coerente tra macchine, non presumere che la sola clonazione delle diapositive garantisca che ogni carattere necessario sia disponibile nell’ambiente di destinazione. Puoi ispezionare i caratteri incorporati con FontsManager::GetEmbeddedFonts e gestire l’incorporamento esplicitamente come descritto in Embed Fonts in Presentations.

Verifica anche di avere il permesso di incorporare i caratteri utilizzati nei file di origine. Le licenze dei caratteri possono limitare l’incorporamento.

Presentazioni protette da password

Una sorgente protetta da password deve essere aperta correttamente prima che le sue diapositive possano essere clonate. Fornisci la password tramite LoadOptions::set_Password.

#include <DOM/LoadOptions.h>
#include <DOM/Presentation.h>

using namespace Aspose::Slides;

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

auto source = System::MakeObject<Presentation>(u"protected.pptx", loadOptions);

Aprire una sorgente crittografata non applica automaticamente la stessa protezione alla presentazione di destinazione. Configura separatamente la protezione dell’output quando necessario.

Presentazioni di grandi dimensioni e uso della memoria

Le presentazioni di grandi dimensioni contenenti immagini ad alta risoluzione, audio, video o altri oggetti binari di grandi dimensioni possono consumare molta memoria. LoadOptions::set_BlobManagementOptions offre controlli per la gestione dei BLOB e l’uso di file temporanei. Vedi Manage Presentation BLOBs per strategie sui file di grandi dimensioni.

Per file di grandi dimensioni, preferisci il caricamento da percorsi di file quando possibile, elimina ogni presentazione di origine non appena è stata unita e evita di salvare ripetutamente risultati intermedi a meno che il flusso di lavoro non richieda checkpoint.

Sicurezza dei thread

Non caricare, modificare, salvare o clonare la stessa Presentation istanza contemporaneamente da più thread. Mantieni ogni istanza di presentazione confinata a una singola operazione di unione. Se parallelizzi lavori indipendenti, usa istanze di presentazione indipendenti e segui le linee guida sul multithreading di Aspose.Slides.

FAQ

Come faccio a mantenere il design originale di ogni presentazione di origine?

Usa AddClone senza fornire un master o un layout di destinazione. Aspose.Slides può clonare automaticamente il master di origine quando è necessario per la diapositiva importata.

Come faccio a far usare alle diapositive importate il tema di destinazione?

Usa la sovraccarico che accetta un master di destinazione. Passa un master dalla presentazione di destinazione, non da quella di origine. Aspose.Slides cercherà di mappare ogni diapositiva di origine a un layout appropriato sotto quel master.

Quando devo usare un layout di destinazione specifico invece di un master di destinazione?

Usa un layout specifico quando ogni diapositiva importata deve utilizzare un layout noto. Usa un master quando vuoi che Aspose.Slides selezioni tra i layout di quel master in base al tipo o al nome del layout di origine.

È possibile unire presentazioni con dimensioni di diapositiva diverse?

Sì, ma il contenuto delle diapositive non viene ridisegnato automaticamente per le dimensioni di destinazione. Ridimensiona prima la presentazione di origine quando hai bisogno di un posizionamento prevedibile, ad esempio con SlideSize::SetSize e SlideSizeScaleType::EnsureFit.

Posso unire file PPT, PPTX e ODP in un unico file?

Sì. Carica ogni presentazione di origine, clona le diapositive necessarie in una destinazione e salva la destinazione in un formato di output supportato. Poiché i formati di presentazione non supportano esattamente lo stesso insieme di funzionalità, verifica i contenuti complessi dopo le unioni cross‑format. Vedi Supported File Formats.

Le sezioni di origine sono preserve automaticamente?

No, non con un semplice ciclo che clona solo le diapositive. Ricrea le sezioni necessarie nella destinazione e usa la sovraccarico di sezione di AddClone quando la struttura delle sezioni deve essere preservata.

Le note del relatore e i commenti sono preservati?

Sono copiate con la diapositiva clonata. Per i flussi di lavoro che dipendono dallo stile del master delle note, dagli autori dei commenti o dai dati di revisione in thread, verifica il risultato unito perché quegli scenari coinvolgono strutture a livello di presentazione oltre al contenuto della diapositiva.

Cosa succede ad audio, video, oggetti OLE e collegamenti ipertestuali?

Il contenuto incorporato viene trasportato come parte delle relazioni di risorsa della diapositiva clonata. I collegamenti esterni rimangono esterni, quindi i file di destinazione o gli URL devono comunque essere disponibili dopo l’unione.

I caratteri incorporati da ogni origine sono garantiti disponibili nella presentazione unita?

Non fare affidamento solo sulla clonazione delle diapositive per la distribuzione dei caratteri. Ispeziona i caratteri incorporati nella destinazione e gestisci esplicitamente l’incorporamento dei caratteri o la disponibilità di caratteri esterni quando la tipografia è importante.

Come unisco un file protetto da password?

Aprilo con il corretto LoadOptions::set_Password, quindi clona le sue diapositive normalmente. La protezione dell’output è configurata separatamente.

Come gestire presentazioni molto grandi?

Usa la gestione dei BLOB quando gli oggetti binari di grandi dimensioni dominano l’uso della memoria, preferisci il caricamento da percorso di file per file molto grandi, elimina prontamente le presentazioni di origine e salva il risultato finale solo quando necessario.

Posso unire diapositive da più thread?

Non utilizzare una singola istanza di Presentation contemporaneamente da più thread. Mantieni ogni operazione di unione isolata nelle proprie istanze di presentazione.

Recuperare e aggiornare le informazioni della presentazione in C++ Operazioni di presentazione low-code in C++