在 C++ 中開啟簡報

本頁內容簡介

了解如何在 C++ 中使用 Aspose.Slides for C++ 開啟 PowerPoint 與 OpenDocument 簡報、提供開啟密碼、控制資源載入，並降低記憶體使用量。

簡介

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

有關密碼偵測、驗證與加密工作流程，請參閱 Password-Protect Presentations。如果已加密的簡報刻意以公開文件屬性儲存，則可在未提供密碼的情況下讀取這些屬性；請參閱 Manage Presentation Properties。

開啟大型簡報

LoadOptions::get_BlobManagementOptions 控制 Aspose.Slides 處理大型二進位物件（如影像、音訊與影片）的方式。您可以保持來源檔案被鎖定、允許使用暫存檔，並限制記憶體中保留的 BLOB 資料量。

以下 C++ 程式碼示範如何載入大型簡報（例如 2 GB）：

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

Note

使用 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();

常見問題

如何判斷檔案已損壞且無法開啟？

Aspose.Slides 會在載入時拋出解析或格式例外。請將此失敗與密碼錯誤分開處理，以便應用程式能正確報告原因。

如果缺少必要的字型會發生什麼情況？

簡報仍可載入，但呈現與匯出時可能會替代字型。您可以設定字型替代或提供自訂字型以使輸出更可預測。

載入簡報時是否也會載入其嵌入式媒體？

嵌入式音訊與影片可透過簡報物件模型取得。外部資源則依照已設定的資源載入行為解析，若無法存取其位置，可能無法使用。

使用 C++ 建立簡報以 C++ 取得與更新簡報資訊