Aspose.Slides FOSS
C++
C++でプレゼンテーションを作成する方法

C++でプレゼンテーションを作成する方法

Aspose.Slides FOSS for C++ を使用すると、Microsoft Office に依存せずに、完全に C++ だけで PowerPoint プレゼンテーションを作成できます。このガイドでは、新しいプレゼンテーションの作成方法、スライドと図形の追加、テキストの書式設定、そして結果の保存方法を示します。

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

ステップ 1: ライブラリを CMake プロジェクトに追加する

CMake FetchContent を使用して、ライブラリを GitHub から直接統合します。C++20 以降が必要です。

cmake_minimum_required(VERSION 3.20)
project(my_slides_app LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

include(FetchContent)
FetchContent_Declare(
    aspose_slides_foss
    GIT_REPOSITORY https://github.com/aspose-slides-foss/Aspose.Slides-FOSS-for-Cpp.git
    GIT_TAG main
)
FetchContent_MakeAvailable(aspose_slides_foss)

add_executable(my_app main.cpp)
target_link_libraries(my_app PRIVATE aspose_slides_foss)

他にシステムパッケージは必要ありません。

ステップ 2: 必要なヘッダーをインクルード 

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

すべての型は Aspose::Slides::Foss 名前空間に存在します。簡潔にするため、以下の例では名前空間エイリアスを使用しています。

namespace asf = Aspose::Slides::Foss;

ステップ 3: プレゼンテーションの作成

スタック上にPresentationを構築します。新しいプレゼンテーションは空白のスライドが1枚で開始します。

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

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

    asf::Presentation prs;
    std::cout << "Slides in new presentation: " << prs.slides().size() << "\n";
    prs.save("output.pptx", asf::SaveFormat::PPTX);
    return 0;
}

重要: スタック割り当てまたは std::unique_ptr を使用して、デストラクタが内部リソースを自動的に解放するようにしてください。

ステップ 4: スライドにアクセスする

最初のスライドはインデックス0にあります。空白のプレゼンテーションには正確に1枚のスライドがあります。

namespace asf = Aspose::Slides::Foss;

asf::Presentation prs;
auto& slide = prs.slides()[0]; // zero-based index
prs.save("output.pptx", asf::SaveFormat::PPTX);

ステップ5: シェイプを追加

slide.shapes().add_auto_shape() を使用して AutoShape を追加します。パラメーターは (shape_type, x, y, width, height) で、すべてポイント単位です (1 ポイント = 1/72 インチ; 標準スライドは 720 x 540 pt)。

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

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

    asf::Presentation prs;
    auto& slide = prs.slides()[0];

    // Rectangle at (50, 50) with 400 wide and 120 tall
    auto& shape = slide.shapes().add_auto_shape(
        asf::ShapeType::RECTANGLE, 50, 50, 400, 120);

    // Set text on the shape's text frame
    shape.text_frame()->set_text("Hello from Aspose.Slides FOSS!");

    prs.save("with-shape.pptx", asf::SaveFormat::PPTX);
    return 0;
}

ステップ 6: プレゼンテーションを保存

prs.save(path, SaveFormat::PPTX) を呼び出すのは、Presentation がスコープから外れる前に行ってください。PPTX は唯一サポートされている出力形式です。

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

ファイルは原子的に書き込まれます; この呼び出しの前にエラーが発生した場合、出力ファイルは作成されません。

完全な作業例

以下のプログラムは、最初のスライドにタイトルシェイプ、2番目のスライドにテーブルを持つ2枚のスライドからなるプレゼンテーションを作成します。

#include <Aspose/Slides/Foss/presentation.h>
#include <vector>
#include <string>

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

    asf::Presentation prs;

    // --- Slide 1: title shape ---
    auto& slide1 = prs.slides()[0];
    auto& title = slide1.shapes().add_auto_shape(
        asf::ShapeType::RECTANGLE, 40, 40, 640, 80);
    title.text_frame()->set_text("Q1 Results: Executive Summary");
    auto& fmt = title.text_frame()->paragraphs()[0].portions()[0].portion_format();
    fmt.set_font_height(32);
    fmt.set_font_bold(asf::NullableBool::TRUE);
    fmt.fill_format().set_fill_type(asf::FillType::SOLID);
    fmt.fill_format().solid_fill_color().set_color(
        asf::Color::from_argb(255, 0, 70, 127));

    // --- Slide 2: table ---
    prs.slides().add_empty_slide(&prs.layout_slides()[0]);
    auto& slide2 = prs.slides()[1];
    std::vector<double> col_w = {200.0, 120.0, 120.0};
    std::vector<double> row_h = {40.0, 40.0, 40.0};
    auto& table = slide2.shapes().add_table(40, 40, col_w, row_h);

    std::vector<std::string> headers = {"Region", "Revenue", "Growth"};
    std::vector<std::vector<std::string>> data = {
        {"North", "$1.2M", "+8%"},
        {"South", "$0.9M", "+4%"},
    };
    for (size_t col = 0; col < headers.size(); ++col) {
        table.rows()[0][col].text_frame()->set_text(headers[col]);
    }
    for (size_t r = 0; r < data.size(); ++r) {
        for (size_t c = 0; c < data[r].size(); ++c) {
            table.rows()[r + 1][c].text_frame()->set_text(data[r][c]);
        }
    }

    prs.save("q1-results.pptx", asf::SaveFormat::PPTX);
    return 0;
}

一般的な問題と対策

Presentation の破棄時にセグフォルトまたはダブルフリー

Presentation が破棄された後にスライドやシェイプへの参照またはポインタを保持しています。slides()、shapes() などが返すすべての参照は、Presentation のデストラクタが実行されると無効になります。Presentation を、その子オブジェクトを使用する期間全体にわたって存続させてください。

SaveFormat::PPTX is not a function コンパイラエラー

SaveFormat::PPTX は列挙値であり、関数ではありません。prs.save("file.pptx", asf::SaveFormat::PPTX) として使用してください。

リンクエラー: 未定義の参照 Aspose::Slides::Foss::Presentation

CMakeLists.txt が target_link_libraries(my_app PRIVATE aspose_slides_foss) を使用してライブラリにリンクされていることを確認してください。

よくある質問

デフォルトのスライドサイズは何ですか？

新しいPresentation()は、標準の10 × 7.5インチ（720 × 540ポイント）サイズのスライドを作成します。このエディションではスライドサイズの変更はまだサポートされていません。

複数のスライドを追加できますか？

はい。prs.slides().add_empty_slide(&prs.layout_slides()[0]) を呼び出して空白スライドを追加し、インデックスでアクセスします：

prs.slides().add_empty_slide(&prs.layout_slides()[0]);
auto& slide2 = prs.slides()[1];

既存のファイルを開いてスライドを追加できますか？

はい：

asf::Presentation prs("existing.pptx");
prs.slides().add_empty_slide(&prs.layout_slides()[0]);
prs.save("existing.pptx", asf::SaveFormat::PPTX);

保存できる形式は何ですか？

SaveFormat::PPTX のみがサポートされています。このエディションでは PDF、HTML、SVG、または画像へのエクスポートは利用できません。

参照

 日本語