Aspose.Slides FOSS
C++
Jak načíst prezentace v C++

Jak načíst prezentace v C++

Aspose.Slides FOSS for C++ lets you open any .pptx soubor, prohlédněte jeho obsah a buď jej uložte zpět do PPTX, nebo z něj extrahujte data. Tento průvodce popisuje otevření souboru, procházení snímků, čtení textu tvarů a zpětné uložení.

Průvodce krok za krokem

Krok 1: Sestavte a propojte knihovnu 

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: Otevřít existující prezentaci

Předávejte cestu k souboru do Presentation konstruktéru. Destruktor provádí úklid.

#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ámé XML části ve zdrojovém souboru jsou zachovány doslovně: knihovna nikdy neodstraňuje obsah, který ještě nezná.

Krok 3: Prozkoumat snímky

Iterujte přes všechny snímky a vytiskněte počet jejich tvarů:

#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: Číst text tvaru

Procházejte tvary a čtěte text z tvarů, které 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: Číst vlastnosti dokumentu

Získejte 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: Zpětné uložení (round‑trip)

Po prozkoumání nebo úpravě prezentace ji uložte zpět do PPTX:

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

Uložení na jinou cestu vytvoří nový soubor. Uložení na stejnou cestu přepíše originál.

Časté problémy a opravy

Soubor nenalezen nebo nelze otevřít

Zkontrolujte, že cesta k .pptx souboru je správná vzhledem k pracovnímu adresáři. Použijte std::filesystem::path pro robustní konstrukci cesty:

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

Výjimka: Formát souboru není podporován

Knihovna podporuje .pptx (Office Open XML) pouze. Starší .ppt (binární PowerPoint 97-2003) soubory nejsou podporovány.

Tvar nemá text_frame

Některé tvary (Connectors, PictureFrames, GroupShapes) nemají textový rámec. Ochráníte to pomocí shape.has_text_frame() před přístupem k textu.

Často kladené otázky

Zachovává načítání veškerý původní obsah?

Ano. Neznámé části XML jsou při uložení v režimu round‑trip zachovány doslovně. Knihovna serializuje pouze ty části modelu dokumentu, které rozumí, a ostatní XML předává beze změny.

Mohu načíst PPTX chráněný heslem?

Prezentace chráněné heslem (šifrované) nejsou v této edici podporovány.

Mohu extrahovat vložené obrázky?

Získejte kolekci obrázků: prs.images() vrací ImageCollection. Každý obrázek má a width(), height(), a binary_data() metoda pro čtení surových obrazových dat.

Je podporováno načítání z paměťového bufferu?

Načítání z std::vector<uint8_t> nebo std::istream není v současném API zpřístupněno. Nejprve zapište bajty do dočasného souboru a poté předávejte cestu k Presentation konstruktoru.

Viz také

 Čeština