Aspose.Slides FOSS
C++
C++でプレゼンテーションを読み込む方法

C++でプレゼンテーションを読み込む方法

Aspose.Slides FOSS for C++ lets you open any .pptx ファイルを検査し、その内容を確認し、PPTX に再保存するかデータを抽出します。このガイドでは、ファイルの開き方、スライドの反復処理、シェイプのテキスト読み取り、そして保存のラウンドトリップについて説明します。.

ステップバイステップ ガイド

ステップ 1: ライブラリをビルドしてリンクする 

git clone https://github.com/aspose-slides-foss/Aspose.Slides-FOSS-for-Cpp.git
cd Aspose.Slides-FOSS-for-Cpp && mkdir build && cd build
cmake .. && cmake --build .

ステップ 2: 既存のプレゼンテーションを開く

ファイルパスを次のものに渡します。 Presentation コンストラクタ。デストラクタはクリーンアップを処理します。.

#include <Aspose/Slides/Foss/presentation.h>
#include <iostream>

int main() {
    namespace asf = Aspose::Slides::Foss;

    asf::Presentation prs("input.pptx");
    std::cout << "Slide count: " << prs.slides().size() << "\n";
    prs.save("output.pptx", asf::SaveFormat::PPTX);
    return 0;
}

ソースファイル内の未知の XML パーツはそのまま保持されます：ライブラリはまだ理解できないコンテンツを削除することはありません。.

ステップ 3: スライドを検査する

すべてのスライドを反復し、シェイプ数を出力します:

#include <Aspose/Slides/Foss/presentation.h>
#include <iostream>

int main() {
    namespace asf = Aspose::Slides::Foss;

    asf::Presentation prs("deck.pptx");
    for (size_t i = 0; i < prs.slides().size(); ++i) {
        auto& slide = prs.slides()[i];
        std::cout << "Slide " << i << ": "
                  << slide.shapes().size() << " shapes\n";
    }
    return 0;
}

ステップ 4: シェイプテキストを読む

シェイプを反復処理し、テキストを持つシェイプからテキストを読み取ります。 TextFrame:

#include <Aspose/Slides/Foss/presentation.h>
#include <iostream>

int main() {
    namespace asf = Aspose::Slides::Foss;

    asf::Presentation prs("deck.pptx");
    for (size_t i = 0; i < prs.slides().size(); ++i) {
        auto& slide = prs.slides()[i];
        for (size_t j = 0; j < slide.shapes().size(); ++j) {
            auto& shape = slide.shapes()[j];
            if (shape.has_text_frame()) {
                auto text = shape.text_frame()->text();
                if (!text.empty()) {
                    std::cout << "  Shape text: " << text << "\n";
                }
            }
        }
    }
    return 0;
}

ステップ 5: ドキュメントプロパティを読む

からコア文書プロパティにアクセスします。 prs.document_properties():

#include <Aspose/Slides/Foss/presentation.h>
#include <iostream>

int main() {
    namespace asf = Aspose::Slides::Foss;

    asf::Presentation prs("deck.pptx");
    auto& props = prs.document_properties();
    std::cout << "Title:   " << props.title() << "\n";
    std::cout << "Author:  " << props.author() << "\n";
    std::cout << "Subject: " << props.subject() << "\n";
    return 0;
}

ステップ 6: ラウンドトリップ保存

プレゼンテーションを検査または変更した後、PPTX に再保存します:

prs.save("output.pptx", asf::SaveFormat::PPTX);

別のパスに保存すると新しいファイルが作成されます。同じパスに保存すると元のファイルが上書きされます。.

一般的な問題と対策

ファイルが見つからない、または開くことができません

パスが正しいことを確認します。 .pptx ファイルが作業ディレクトリに対して正しい相対パスであることを確認します。使用します。 std::filesystem::path 堅牢なパス構築のために:

#include <filesystem>
auto path = std::filesystem::path(__FILE__).parent_path() / "assets" / "deck.pptx";
asf::Presentation prs(path.string());

例外: ファイル形式はサポートされていません

このライブラリはサポートしています。 .pptx (Office Open XML) のみ。レガシー .ppt (binary PowerPoint 97-2003) ファイルはサポートされていません。.

シェイプに text_frame がありません

一部のシェイプ（Connectors、PictureFrames、GroupShapes）にはテキストフレームがありません。アクセスする前にガードしてください。 shape.has_text_frame() テキストにアクセスする前に.

よくある質問

読み込みは元のコンテンツをすべて保持しますか？?

はい。未知の XML パーツは往復保存時にそのまま保持されます。ライブラリはドキュメントモデルで理解できる部分だけをシリアライズし、認識できない XML はそのまま通過させます。.

パスワードで保護された PPTX を読み込めますか？?

パスワード保護（暗号化）されたプレゼンテーションはこのエディションではサポートされていません。.

埋め込み画像を抽出できますか？?

画像コレクションにアクセスする: prs.images() 返すのは ImageCollection.。各画像には width(), height(),、そして binary_data() 生画像データを読み取るメソッドです。.

メモリバッファからの読み込みはサポートされていますか？?

からのロードは std::vector<uint8_t> または std::istream は現在の API では公開されていません。まずバイトを一時ファイルに書き込み、次にそのパスを Presentation コンストラクタに。.

参照

 日本語