Aspose.Slides FOSS
C++
Как загружать презентации в C++

Как загружать презентации в C++

Aspose.Slides FOSS for C++ lets you open any .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: Чтение текста фигур

Итерируйте фигуры и читайте текст из фигур, которые имеют a 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: Сохранение в режиме round‑trip

После просмотра или изменения презентации сохраните её обратно в 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 (binary PowerPoint 97-2003) файлы не поддерживаются.

У объекта Shape нет 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 конструктору.

См. также

 Русский