Руководство разработчика

Это руководство охватывает основные возможности Aspose.Slides FOSS для C++ с компилируемыми примерами кода для каждой области функций.

В этом разделе

СтраницаОписание
Возможности и функцииПолный список поддерживаемых функций: слайды, фигуры, текст, заливка, эффекты, 3D‑форматирование, заметки, комментарии, изображения и свойства документа.
Работа с изображениямиВстраивание изображений в слайды в виде рамок‑картинок из файла или векторного массива байтов; управление режимом заливки (растягивание, мозаика).
Работа с соединителямиДобавление изогнутых, угловых и прямых соединителей между фигурами; установка точек соединения и стиля линии.
Работа с 3D-эффектамиПрименяйте внешнюю тень, свечение, размытие, фаску, предустановки камеры, световые установки и материалы к формам.
Работа с комментариямиДобавляйте вложенные комментарии обзора и заметки докладчика; управляйте авторами комментариев; читайте аннотации.

Точка входа API

Каждая операция начинается с Presentation объекта. Он использует RAII для автоматической очистки ресурсов:

#include <Aspose/Slides/Foss/presentation.h>
#include <Aspose/Slides/Foss/export/save_format.h>

using namespace Aspose::Slides::Foss;

// Open existing
{
    Presentation pres("input.pptx");
    // work with pres
    pres.save("output.pptx", SaveFormat::PPTX);
}

// Create new
{
    Presentation pres;
    // work with pres
    pres.save("new.pptx", SaveFormat::PPTX);
}

Когда Presentation объект выходит из области видимости, внутренние ресурсы XML/OPC освобождаются. Вы также можете вызвать pres.dispose() явно; вызов его несколько раз безопасен.

Поддерживаемый формат вывода

Единственный поддерживаемый формат сохранения — PPTX (SaveFormat::PPTX). Экспорт в PDF, HTML, SVG или форматы изображений недоступен в этой версии.

Ключевые классы

Класс / ПеречислениеЗаголовокОписание
Presentationpresentation.hКорневой контейнер; использует RAII для управления ресурсами
ShapeTypeshape_type.hПеречисление типов фигур (RECTANGLE, ELLIPSE, …)
FillTypefill_type.hПеречисление для типов заливки (SOLID, GRADIENT, …)
NullableBoolnullable_bool.hТрёхсостоянийный булев тип для форматирования (TRUE, FALSE, NOT_DEFINED)
SaveFormatexport/save_format.hПеречисление форматов вывода (поддерживается только PPTX)
Colordrawing/color.hКонструктор цвета ARGB
PointFdrawing/point_f.hДвумерная точка с плавающей запятой (используется для позиций комментариев)

Все заголовки находятся под Aspose/Slides/Foss/. Пространство имён Aspose::Slides::Foss. Типы рисования используют Aspose::Slides::Foss::Drawing.

Известные ограничения

Следующие области недоступны в этой версии:

  • Диаграммы: создание или изменение диаграмм не поддерживается
  • SmartArt: не поддерживается
  • Анимации и переходы: переходы слайдов и анимацию объектов нельзя задать
  • Форматы экспорта: поддерживается только сохранение в PPTX; нет экспорта PDF, HTML, SVG или изображений
  • Гиперссылки и настройки действий: объекты ссылок не могут быть изменены
  • VBA‑макросы и цифровые подписи: недоступно

Неизвестные части XML, обнаруженные при загрузке, сохраняются дословно при сохранении, поэтому при обратном преобразовании содержимое, которое библиотека ещё не понимает, никогда не удаляется.

См. также

 Русский