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

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

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

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

Точка входа API

Каждая операция начинается с Presentation объекта. Всегда используйте его внутри блока try-with-resources:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.export.SaveFormat;

// Open existing
try (Presentation prs = new Presentation("input.pptx")) {
    // work with prs
    prs.save("output.pptx", SaveFormat.PPTX);
}

// Create new
try (Presentation prs = new Presentation()) {
    // work with prs
    prs.save("new.pptx", SaveFormat.PPTX);
}

Блок try-with-resources гарантирует, что внутренние ресурсы XML будут освобождены при выходе из блока. Не храните Presentation ссылку за пределами блока try.

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

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

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

Класс / ПеречислениеПакетОписание
Presentationorg.aspose.slides.fossКорневой контейнер; используйте в try-with-resources
ShapeTypeorg.aspose.slides.fossПеречисление для типов фигур (RECTANGLE, ELLIPSE, …)
FillTypeorg.aspose.slides.fossПеречисление для типов заливки (SOLID, GRADIENT, …)
NullableBoolorg.aspose.slides.fossТрёхсостоящий булев тип для форматирования (TRUE, FALSE, NOT_DEFINED)
SaveFormatorg.aspose.slides.foss.exportПеречисление форматов вывода (поддерживается только PPTX)
Colororg.aspose.slides.foss.drawingКонструктор цвета ARGB
PointForg.aspose.slides.foss.drawingДвумерная точка с плавающей запятой (используется для позиций комментариев)

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

Следующие области вызывают UnsupportedOperationException в этом издании:

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

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

См. также

 Русский