C++ でプレゼンテーションを開く

このページの概要

C++ で PowerPoint および OpenDocument プレゼンテーションを開く方法、開く際のパスワードの指定、リソース読み込みの制御、そして Aspose.Slides for 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();

パスワードの検出、検証、暗号化ワークフローについては、Password-Protect Presentations を参照してください。暗号化されたプレゼンテーションが意図的に公開ドキュメントプロパティと共に保存された場合、パスワードなしでこれらのプロパティを読み取ることができます。詳細は Manage Presentation Properties をご覧ください。

大きなプレゼンテーションを開く

LoadOptions::get_BlobManagementOptions は、画像、音声、ビデオなどの大きなバイナリオブジェクトの処理方法を制御します。ソースファイルをロックしたままにしたり、一時ファイルを許可したり、メモリに保持する 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();

FAQ

ファイルが破損していて開けないことをどう判断できますか？

Aspose.Slides は読み込み中にパースエラーまたはフォーマット例外をスローします。この失敗をパスワードが間違っているエラーとは別に処理し、アプリケーションが原因を正確に報告できるようにします。

必要なフォントが欠落している場合はどうなりますか？

プレゼンテーションは引き続き読み込めますが、レンダリングやエクスポート時にフォントが代替されることがあります。出力をより予測可能にするために、font substitution を構成するか、custom fonts を提供できます。

プレゼンテーションの読み込みは埋め込みメディアも読み込みますか？

埋め込みの音声および動画はプレゼンテーションオブジェクトモデルを通じて利用可能になります。外部リソースは設定されたリソース読み込み動作に従って解決され、場所にアクセスできない場合は利用できないことがあります。

C++ でプレゼンテーションを作成 C++ でプレゼンテーション情報を取得および更新する