Aspose.Slides voľný a otvorený softvér
C++
Ako načítať prezentácie v C++

Ako načítať prezentácie v C++

Aspose.Slides FOSS for C++ vám umožňuje otvoriť akýkoľvek .pptx súbor, skontrolovať jeho obsah a buď ho uložiť späť do PPTX, alebo z neho extrahovať dáta. Tento sprievodca pokrýva otvorenie súboru, prechádzanie snímkami, čítanie textu tvarov a spätné uloženie.

Sprievodca krok za krokom

Krok 1: Zostavte a prepojte knižnicu 

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: Otvorte existujúcu prezentáciu

Zadajte cestu k súboru do konštruktora Presentation. Destruktor sa postará o čistenie.

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

Neznáme XML časti v zdrojovom súbore sú zachované doslovne: knižnica nikdy neodstraňuje obsah, ktorý ešte nerozumeje.

Krok 3: Skontrolovať snímky

Iterujte cez všetky snímky a vypíšte počet ich tvarov:

#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: Prečítať text tvaru

Iterujte cez tvary a prečítajte text z tvarov, ktoré 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: Prečítanie vlastností dokumentu

Získajte základné vlastnosti 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: Uloženie v oboch smeroch

Po skontrolovaní alebo úprave prezentácie ju uložte späť do PPTX:

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

Ukladanie do inej cesty vytvorí nový súbor. Ukladanie do rovnakej cesty prepíše pôvodný.

Bežné problémy a riešenia

Súbor nebol nájdený alebo ho nie je možné otvoriť

Skontrolujte, či je cesta k súboru .pptx správna vzhľadom na pracovný adresár. Použite std::filesystem::path pre robustnú konštrukciu cesty:

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

Výnimka: Formát súboru nie je podporovaný

Knižnica podporuje iba .pptx (Office Open XML). Súbory staršej verzie .ppt (binárny PowerPoint 97‑2003) nie sú podporované.

Tvar nemá text_frame

Niektoré tvary (Connectors, PictureFrames, GroupShapes) nemajú textový rám. Pred prístupom k textu použite shape.has_text_frame().

Často kladené otázky

Zachová načítanie celý pôvodný obsah?

Áno. Neznáme časti XML sa pri uložení v režime round‑trip zachovajú doslovne. Knižnica serializuje iba časti modelu dokumentu, ktoré rozumie, a prechádza akékoľvek XML, ktoré nepozná.

Môžem načítať PPTX chránený heslom?

Prezentácie chránené heslom (šifrované) nie sú v tejto edícii podporované.

Môžem extrahovať vložené obrázky?

Prístup k zbierke obrázkov: prs.images() vracia ImageCollection. Každý obrázok má metódy width(), height() a binary_data() na čítanie surových dát obrázka.

Je načítanie z pamäťového bufferu podporované?

Načítanie z std::vector<uint8_t> alebo std::istream nie je v súčasnom API podporované. Najprv zapíšte bajty do dočasného súboru a potom odovzdajte cestu konštruktoru Presentation.

Pozri tiež

 Slovenčina