Структура презентации

Презентация имеет более простую структуру, чем текстовый документ, большинство элементов презентации вложены в элемент слайда, а все остальные элементы размещены на нем. Один или несколько элементов слайда являются частью элемента презентации.

Если вам нужно, чтобы все слайды содержали одинаковые шрифты и изображения, следует использовать образец слайдов. Он состоит из тех же элементов, что и слайд.

Макет можно добавить к слайду, чтобы указать его структуру. Также некоторые нарисованные объекты — изображения, фигуры, диаграммы — можно размещать прямо на слайде или макете слайда. Плейсхолдер можно добавить в форму.

Текст нельзя разместить непосредственно на слайде, его можно только сгруппировать в абзацы и добавить в фигуры или таблицы. Для удобства (так как с меньшими блоками всегда легче работать, чем с большими) текст обычно разбивается на небольшие текстовые части, называемые прогонами. Каждый абзац может состоять как из одного прогона текста, так и иметь их внутри несколько десятков, в зависимости от сложности абзаца.

Создание новой презентации

Самый простой пример презентации с одним слайдом без каких-либо объектов можно построить с помощью Документ Конструктора, используя следующий код:

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, чтобы узнать, какие методы позволяют изменять определенные свойства форматирования документа и элемента презентации.