Структура презентации
Презентация имеет более простую структуру, чем текстовый документ, большинство элементов презентации вложены в элемент слайда, а все остальные элементы размещены на нем. Один или несколько элементов слайда являются частью элемента презентации.
Если вам нужно, чтобы все слайды содержали одинаковые шрифты и изображения, следует использовать образец слайдов. Он состоит из тех же элементов, что и слайд.
Макет можно добавить к слайду, чтобы указать его структуру. Также некоторые нарисованные объекты — изображения, фигуры, диаграммы — можно размещать прямо на слайде или макете слайда. Плейсхолдер можно добавить в форму.
Текст нельзя разместить непосредственно на слайде, его можно только сгруппировать в абзацы и добавить в фигуры или таблицы. Для удобства (так как с меньшими блоками всегда легче работать, чем с большими) текст обычно разбивается на небольшие текстовые части, называемые прогонами. Каждый абзац может состоять как из одного прогона текста, так и иметь их внутри несколько десятков, в зависимости от сложности абзаца.
Создание новой презентации
Самый простой пример презентации с одним слайдом без каких-либо объектов можно построить с помощью Документ Конструктора, используя следующий код:
builder.CreateFile("pptx"); // create a presentation file in the .pptx format
var oPresentation = Api.GetPresentation(); // create a new 'oPresentation' variable and get the created presentation contents
var oSlide = oPresentation.GetSlideByIndex(0); // get the first slide
oSlide.RemoveAllObjects(); // remove all objects from the first slide
builder.SaveFile("pptx", "example.pptx"); // save the resulting presentation as a file in the .pptx format with a new 'example.pptx' name
builder.CloseFile(); // close the presentation file and finish work
Открытие существующей презентации
Если вы хотите отредактировать уже существующую презентацию, вы можете открыть ее с помощью Документ Конструктора, получить ее элементы и изменить их по своему усмотрению. Единственное отличие от редактора презентаций в этом случае будет заключаться в том, что этот редактор презентаций вам не понадобится. Презентация открывается следующим образом:
builder.OpenFile("https://example.com/mypresentation.pptx"); // use a path to an existing 'mypresentation.pptx' presentation file to open it with
var oPresentation = Api.GetPresentation(); // create a new 'oPresentation' variable and get the created presentation contents
var oSlide = oPresentation.GetSlideByIndex(0); // get the first slide
oSlide.RemoveAllObjects(); // remove all objects from the first slide
builder.SaveFile("pptx", "example.pptx"); // save the resulting presentation as a file in the .pptx format with a new 'example.pptx' name
builder.CloseFile(); // close the presentation file and finish work with
Как видите, вам просто нужно использовать builder.OpenFile(); метод класса CDocBuilder с путем к нужной презентации в качестве аргумента для ее открытия. В приведенном выше примере мы открываем презентацию mypresentation.pptx, получаем ее первый слайд и удаляем из нее все объекты. Точно так же можно изменить любой другой элемент презентации.
Используйте соответствующие разделы документации по API, чтобы узнать, какие методы позволяют изменять определенные свойства форматирования документа и элемента презентации.