Открытие презентаций в C++

О чём эта страница

Узнайте, как открывать презентации PowerPoint и OpenDocument в C++, задавать пароли открытия, управлять загрузкой ресурсов и уменьшать использование памяти с помощью Aspose.Slides для C++.

Введение

Aspose.Slides for C++ может загружать презентации PowerPoint и OpenDocument из файлов и потоков. После загрузки презентации вы можете исследовать её структуру, редактировать слайды, управлять ресурсами и сохранять её в исходном или другом поддерживаемом формате.

Поведение загрузки можно настроить с помощью класса LoadOptions. Например, вы можете указать пароль для открытия, держать крупные бинарные объекты вне памяти, контролировать внешние ресурсы или опустить встроенные бинарные данные.

Открытие презентаций

Чтобы открыть существующую презентацию, передайте путь к файлу в конструктор Presentation. Освободите объект презентации после использования, чтобы дескрипторы файлов, временные данные и другие ресурсы были быстро освобождены.

Следующий пример на C++ показывает, как открыть презентацию и получить количество её слайдов:

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

using namespace Aspose::Slides;
using namespace System;

auto presentation = MakeObject<Presentation>(u"sample.pptx");

Console::WriteLine(u"Slide count: {0}", presentation->get_Slides()->get_Count());

presentation->Dispose();

Открытие презентаций, защищённых паролем

Пароль открытия шифрует содержимое презентации. Чтобы загрузить полную презентацию, передайте правильный пароль в LoadOptions::set_Password и передайте параметры в конструктор Presentation. Загрузка завершится неудачей, если пароль отсутствует или неверен.

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

using namespace Aspose::Slides;
using namespace System;

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

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

Console::WriteLine(u"Slide count: {0}", presentation->get_Slides()->get_Count());

presentation->Dispose();

Для обнаружения пароля, проверки и процессов шифрования см. Защита презентаций паролем. Если зашифрованная презентация была сознательно сохранена с открытыми свойствами документа, эти свойства можно прочитать без пароля; см. Управление свойствами презентации.

Открытие больших презентаций

LoadOptions::get_BlobManagementOptions управляет тем, как Aspose.Slides обрабатывает крупные бинарные объекты, такие как изображения, аудио и видео. Вы можете держать исходный файл заблокированным, разрешать временные файлы и ограничивать объём BLOB‑данных, хранящихся в памяти.

Следующий код на C++ демонстрирует загрузку большой презентации (например, 2 ГБ):

#include <DOM/ISlide.h>
#include <DOM/LoadOptions.h>
#include <DOM/Presentation.h>
#include <Export/SaveFormat.h>
#include <IBlobManagementOptions.h>
#include <PresentationLockingBehavior.h>

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

const String filePath = u"large-presentation.pptx";

auto loadOptions = MakeObject<LoadOptions>();
auto blobOptions = loadOptions->get_BlobManagementOptions();
blobOptions->set_PresentationLockingBehavior(PresentationLockingBehavior::KeepLocked);
blobOptions->set_IsTemporaryFilesAllowed(true);
blobOptions->set_MaxBlobsBytesInMemory(10 * 1024 * 1024);

auto presentation = MakeObject<Presentation>(filePath, loadOptions);

presentation->get_Slide(0)->set_Name(u"Large presentation");
presentation->Save(u"large-presentation-copy.pptx", SaveFormat::Pptx);

presentation->Dispose();

Примечание

С PresentationLockingBehavior::KeepLocked исходный файл остаётся заблокированным до тех пор, пока объект Presentation не будет освобождён. Не перемещайте, не перезаписывайте и не удаляйте исходный файл, пока этот объект жив.

Aspose.Slides может копировать содержимое входного потока при загрузке. Для больших презентаций путь к файлу, как правило, более эффективен, чем поток. См. Manage BLOBs для дополнительных вариантов хранения и управления памятью.

Управление внешними ресурсами

LoadOptions::set_ResourceLoadingCallback принимает реализацию IResourceLoadingCallback. Обратный вызов может предоставить заменяющие данные, перенаправить ресурс, использовать загрузчик по умолчанию или пропустить ресурс. Это полезно, когда презентации содержат внешние изображения, которые должны разрешаться согласно правилам безопасности или хранения, специфичным для приложения.

#include <DOM/ISlideCollection.h>
#include <DOM/LoadOptions.h>
#include <DOM/Presentation.h>
#include <IResourceLoadingArgs.h>
#include <IResourceLoadingCallback.h>
#include <ResourceLoadingAction.h>
#include <system/console.h>
#include <system/io/file.h>
#include <system/string_comparison.h>

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

class ImageLoadingHandler : public IResourceLoadingCallback
{
public:
    ResourceLoadingAction ResourceLoading(SharedPtr<IResourceLoadingArgs> args) override
    {
        auto isJpeg = args->get_OriginalUri().EndsWith(u".jpg", StringComparison::OrdinalIgnoreCase);
        if (!isJpeg || !File::Exists(u"approved-image.jpg"))
        {
            return ResourceLoadingAction::Skip;
        }

        auto imageData = File::ReadAllBytes(u"approved-image.jpg");
        args->SetData(imageData);
        return ResourceLoadingAction::UserProvided;
    }
};

auto loadOptions = MakeObject<LoadOptions>();
loadOptions->set_ResourceLoadingCallback(MakeObject<ImageLoadingHandler>());

auto presentation = MakeObject<Presentation>(u"presentation-with-external-images.pptx", loadOptions);
Console::WriteLine(u"Slide count: {0}", presentation->get_Slides()->get_Count());

presentation->Dispose();

Загрузка презентаций без встроенных бинарных объектов

Презентация может содержать встроенные бинарные данные, которые приложению не нужны или которые оно не желает сохранять. Примеры:

VBA‑проекты, доступные через IPresentation::get_VbaProject;
встроенные данные OLE, доступные через IOleEmbeddedDataInfo::get_EmbeddedFileData;
данные ActiveX‑контролов, доступные через IControl::get_ActiveXControlBinary.

Передайте true в LoadOptions::set_DeleteEmbeddedBinaryObjects, чтобы удалить эти бинарные данные при загрузке. Сохраните загруженную презентацию, чтобы зафиксировать очищенный результат.

Этот параметр уменьшает риск наличия нежелательных встроенных полезных нагрузок, но не является полноценной системой обнаружения вредоносного кода или санитаризации контента.

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

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

auto loadOptions = MakeObject<LoadOptions>();
loadOptions->set_DeleteEmbeddedBinaryObjects(true);

auto presentation = MakeObject<Presentation>(u"presentation-with-embedded-data.pptx", loadOptions);

presentation->Save(u"presentation-without-embedded-data.pptx", SaveFormat::Pptx);

presentation->Dispose();

FAQ

Как понять, что файл повреждён и его нельзя открыть?

Aspose.Slides генерирует исключение парсинга или формата во время загрузки. Обрабатывайте эту ошибку отдельно от ошибки неправильного пароля, чтобы приложение могло точно сообщить о причине.

Что происходит, если требуемые шрифты отсутствуют?

Презентацию всё равно можно загрузить, но при рендеринге и экспорте могут быть заменены шрифты. Вы можете configure font substitution или provide custom fonts для более предсказуемого вывода.

Загружает ли загрузка презентации также её встроенные медиа‑файлы?

Встроенные аудио и видео становятся доступными через объектную модель презентации. Внешние ресурсы разрешаются согласно настроенному поведению загрузки ресурсов и могут быть недоступны, если их местоположения недоступны.

Создание презентаций на C++ Получить и обновить информацию о презентации на C++