Aspose.Slides FOSS
C++
Как да заредим презентации в C++

Как да заредим презентации в C++

Aspose.Slides FOSS for C++ ви позволява да отворите всеки .pptx файл, да прегледате съдържанието му и или да го запазите обратно като PPTX, или да извлечете данни от него. Това ръководство обхваща отварянето на файл, обхождането на слайдовете, четенето на текста на формите и запазването с обратен процес.

Ръководство стъпка по стъпка

Стъпка 1: Създаване и свързване на библиотеката 

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 .

Стъпка 2: Отворете съществуваща презентация

Предайте пътя към файла на конструктора Presentation. Деструкторът се грижи за почистването.

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

Неизвестните XML части в изходния файл се запазват дословно: библиотеката никога не премахва съдържание, което все още не разбира.

Стъпка 3: Преглед на слайдовете

Итерарайте през всички слайдове и отпечатайте броя им на форми:

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

Стъпка 4: Прочетете текста на формата

Итерайте през формите и прочетете текста от формите, които имат 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;
}

Стъпка 5: Прочетете свойствата на документа

Достъп до основните свойства на документа от 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;
}

Стъпка 6: Запис в обратен цикъл

След като инспектирате или промените презентацията, запишете я обратно в PPTX:

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

Записването в различен път създава нов файл. Записването в същия път презаписва оригинала.

Общи проблеми и решения

Файлът не е намерен или не може да се отвори

Проверете дали пътят към файла .pptx е правилен спрямо работната директория. Използвайте std::filesystem::path за надеждно конструиране на пътя:

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

Изключение: Форматът на файла не се поддържа

Библиотеката поддържа само .pptx (Office Open XML). Наследените .ppt (двоичен PowerPoint 97-2003) файлове не се поддържат.

Формата няма text_frame

Някои форми (Connectors, PictureFrames, GroupShapes) нямат текстова рамка. Защитете се с shape.has_text_frame() преди достъп до текста.

Често задавани въпроси

Запазва ли зареждането цялото оригинално съдържание?

Да. Неизвестните XML части се запазват дословно при запазване в обратен цикъл. Библиотеката сериализира само частите от модела на документа, които разбира, и пропуска всякакъв XML, който не разпознава.

Мога ли да заредя PPTX, защитен с парола?

Презентациите, защитени с парола (шифрирани), не се поддържат в това издание.

Мога ли да извлека вградени изображения?

Достъп до колекцията от изображения: prs.images() връща ImageCollection. Всяко изображение има методи width(), height() и binary_data() за четене на необработените данни на изображението.

Поддържа ли се зареждане от буфер в паметта?

Зареждането от std::vector<uint8_t> или std::istream не е достъпно в текущия API. Първо запишете байтовете във временен файл, след което предайте пътя към конструктора Presentation.

Вижте още

 Български