Jak ładować prezentacje w C++

Aspose.Slides FOSS for C++ pozwala otworzyć dowolny plik .pptx, sprawdzić jego zawartość i albo zapisać go ponownie jako PPTX, albo wyodrębnić z niego dane. Ten przewodnik obejmuje otwieranie pliku, iterację slajdów, odczytywanie tekstu kształtów oraz zapis 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ę pliku do konstruktora Presentation. 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: Sprawdź 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: Odczyt tekstu 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: Odczyt 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: Zapis w trybie dwukierunkowym

Po sprawdzeniu lub modyfikacji prezentacji, zapisz ją ponownie jako PPTX:

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

Zapisywanie w inną ścieżkę tworzy nowy plik. Zapisywanie w tej samej ścieżce nadpisuje oryginał.

Typowe problemy i rozwiązania

Plik nie został znaleziony lub nie można go otworzyć

Sprawdź, czy ścieżka do pliku .pptx jest poprawna względem katalogu roboczego. Użyj std::filesystem::path do solidnego budowania ś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 wyłącznie .pptx (Office Open XML). Pliki starszego formatu .ppt (binarny 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 się przy użyciu shape.has_text_frame() przed dostępem do tekstu.

Najczęściej zadawane pytania

Czy ładowanie zachowuje całą oryginalną treść?

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, i przepuszcza wszelkie XML, których nie rozpoznaje.

Czy mogę załadować plik PPTX zabezpieczony hasłem?

Prezentacje chronione 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 metodę width(), height() i binary_data() do odczytu surowych danych obrazu.

Czy ładowanie 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 konstruktora Presentation.