Jak ładować prezentacje w C++

Aspose.Slides FOSS for C++ lets you open any .pptx plik, sprawdź jego zawartość i albo zapisz go ponownie jako PPTX, albo wyodrębnij z niego dane. Ten przewodnik opisuje otwieranie pliku, iterowanie slajdów, odczytywanie tekstu kształtów oraz zapisywanie w trybie round‑trip.

Przewodnik krok po kroku

Krok 1: Zbuduj i połącz bibliotekę

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 .

Krok 2: Otwórz istniejącą prezentację

Przekaż ścieżkę do pliku do Presentation konstruktora. Destruktor zajmuje się sprzątaniem.

#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;
}

Nieznane części XML w pliku źródłowym są zachowywane dosłownie: biblioteka nigdy nie usuwa treści, której jeszcze nie rozumie.

Krok 3: Przeglądaj slajdy

Iteruj po wszystkich slajdach i wypisz liczbę ich kształtów:

#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;
}

Krok 4: Odczytaj tekst kształtu

Iteruj po kształtach i odczytuj tekst z kształtów, które mają 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;
}

Krok 5: Odczytaj właściwości dokumentu

Uzyskaj dostęp do podstawowych właściwości dokumentu z 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;
}

Krok 6: Zapisz w trybie round‑trip

Po przeglądzie lub modyfikacji prezentacji zapisz ją ponownie jako PPTX:

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

Zapis pod inną ścieżką tworzy nowy plik. Zapis pod tą samą ścieżką nadpisuje oryginał.

Typowe problemy i rozwiązania

Plik nie znaleziony lub nie można go otworzyć

Sprawdź, czy ścieżka do .pptx pliku jest poprawna względem katalogu roboczego. Użyj std::filesystem::path do solidnej konstrukcji ścieżek:

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

Wyjątek: Format pliku nie jest obsługiwany

Biblioteka obsługuje .pptx (Office Open XML) tylko. Starsze .ppt (binarne pliki PowerPoint 97-2003) nie są obsługiwane.

Kształt nie ma text_frame

Niektóre kształty (Connectors, PictureFrames, GroupShapes) nie mają ramki tekstowej. Zabezpiecz przed shape.has_text_frame() przed dostępem do tekstu.

Najczęściej zadawane pytania

Czy wczytywanie zachowuje całą oryginalną zawartość?

Tak. Nieznane części XML są zachowywane dosłownie przy zapisie w trybie round‑trip. Biblioteka serializuje tylko te części modelu dokumentu, które rozumie, a pozostałe XML‑y przepuszcza dalej.

Czy mogę wczytać zabezpieczony hasłem plik PPTX?

Prezentacje zabezpieczone hasłem (zaszyfrowane) nie są obsługiwane w tej edycji.

Czy mogę wyodrębnić osadzone obrazy?

Uzyskaj dostęp do kolekcji obrazów: prs.images() zwraca ImageCollection. Każdy obraz ma width(), height(), oraz binary_data() metodę do odczytu surowych danych obrazu.

Czy wczytywanie z bufora w pamięci jest obsługiwane?

Ładowanie z std::vector<uint8_t> lub std::istream nie jest udostępnione w bieżącym API. Najpierw zapisz bajty do pliku tymczasowego, a następnie przekaż ścieżkę do Presentation konstruktora.