Aspose.Slides FOSS
C++
Cum să încărcați prezentări în C++

Cum să încărcați prezentări în C++

Aspose.Slides FOSS for C++ lets you open any .pptx fișier, inspectați conținutul său și fie să îl salvați înapoi în PPTX, fie să extrageți date din el. Acest ghid acoperă deschiderea unui fișier, iterarea diapozitivelor, citirea textului din forme și salvarea prin round‑tripping.

Ghid pas cu pas

Pasul 1: Compilați și legați biblioteca 

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 .

Pasul 2: Deschideți o prezentare existentă

Transmiteți calea fișierului către Presentation constructor. Destructorul se ocupă de curățare.

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

Părțile XML necunoscute din fișierul sursă sunt păstrate literalmente: biblioteca nu elimină niciodată conținutul pe care nu îl înțelege încă.

Pasul 3: Inspectați diapozitivele

Iterați prin toate diapozitivele și afișați numărul de forme al fiecăruia:

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

Pasul 4: Citiți textul formei

Iterați peste forme și citiți textul din formele care au un 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;
}

Pasul 5: Citiți proprietățile documentului

Accesați proprietățile de bază ale documentului din 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;
}

Pasul 6: Salvare round‑trip

După ce ați inspectat sau modificat prezentarea, salvați-o înapoi în PPTX:

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

Salvarea într-o cale diferită creează un fișier nou. Salvarea în aceeași cale suprascrie fișierul original.

Probleme comune și soluții

Fișierul nu a fost găsit sau nu poate fi deschis

Verificați că calea către .pptx fișier este corectă în raport cu directorul de lucru. Utilizați std::filesystem::path pentru construcție robustă a căii:

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

Excepție: Formatul fișierului nu este suportat

Biblioteca suportă .pptx (Office Open XML) doar. Legacy .ppt (binary PowerPoint 97-2003) fișierele nu sunt suportate.

Forma nu are text_frame

Unele forme (Connectors, PictureFrames, GroupShapes) nu au un cadru de text. Protejați cu shape.has_text_frame() înainte de a accesa textul.

Întrebări frecvente

Încărcarea păstrează tot conținutul original?

Da. Părțile XML necunoscute sunt păstrate exact la salvarea în buclă. Biblioteca serializează doar părțile modelului de document pe care le înțelege și transmite prin orice XML pe care nu îl recunoaște.

Pot încărca un PPTX protejat prin parolă?

Prezentările protejate prin parolă (criptate) nu sunt suportate în această ediție.

Pot extrage imaginile încorporate?

Accesați colecția de imagini: prs.images() returnează ImageCollection. Fiecare imagine are un width(), height(), și binary_data() metodă pentru a citi datele brute ale imaginii.

Este suportată încărcarea dintr-un buffer în memorie?

Încărcarea dintr-un std::vector<uint8_t> sau std::istream nu este expusă în API-ul curent. Scrieți octeții într-un fișier temporar mai întâi, apoi transmiteți calea către Presentation constructorul.

Vezi și

 Română