Добавить слайды

Чтобы добавить слайд в презентацию, используйте PPT API для добавления слайда на основе макета слайда, определенного в шаблоне презентации PowerPoint ®. Если шаблон не включает компоновку слайдов, соответствующую вашим требованиям, можно добавить компоновку слайдов. Дополнительные сведения см. в разделе Добавление компоновки слайдов.

Чтобы добавить слайд, используйте add метод с помощью mlreportgen.ppt.Presentation объект. Например, используя шаблон PPT API по умолчанию, можно добавить слайд, используя формат слайдов «Заголовок» и «Содержимое».

import mlreportgen.ppt.*;
slides = Presentation('myPresentation');
slide1 = add(slides,'Title and Content');

При добавлении слайда PPT API создает mlreportgen.ppt.Slide объект. Однако невозможно добавить слайд с помощью Slide конструктор.

Указание порядка слайдов

По умолчанию порядок добавления слайдов в программе PPT API определяет порядок отображения слайдов. Например, этот код делает titleSlide сдвинуть первый слайд в презентации. contentSlide слайд - второй слайд.

slides = Presentation('myPresentation');
titleSlide = add(slides,'Title Slide');
contentSlide = add(slides,'Title and Content');

При добавлении слайда, чтобы явно указать порядок, в котором он отображается, можно:

Укажите слайд, которому предшествует новый слайд. Этот подход полезен для сохранения слайдов вместе при добавлении или удалении слайдов.
Укажите индекс, указывающий числовое положение слайда в презентации. Этот подход полезен, если требуется, чтобы слайд всегда отображался в одном и том же числовом положении.

При первом подходе новый слайд размещается непосредственно перед указанным слайдом. Если ссылочный слайд был создан с помощью PPT API, можно указать Slide объект. Например, используя шаблон PPT API по умолчанию, этот код вызывает pictureSlide появиться непосредственно перед introSlide.

slides = Presentation('myPresentation');
titleSlide = add(slides,'Title Slide');
introSlide = add(slides,'Title Slide');
pictureSlide = add(slides,'Title and Picture',introSlide);

В презентации, созданной с помощью PowerPoint, добавление слайда непосредственно перед слайдом, созданным с помощью PowerPoint, требует нескольких шагов.

В PowerPoint определите положение опорного слайда, которому должен предшествовать новый слайд.
Откройте программу PPT API и присвойте имя эталонному слайду, который требуется позиционировать перед новым слайдом. Например, предположим, что эталонный слайд является вторым слайдом в презентации PowerPoint.
```
slides = Presentation('myPresentation','myPresentation');
open(slides);

slides.Children(2).Name = 'ReferenceSlide';
close(slides);
```
Чтобы определить ссылочный объект слайда, используйте имя слайда. Добавьте новый слайд относительно опорного слайда.
```
slides = Presentation('myPresentation', 'myPresentation');
open(slides);

refSlide = find(slides, 'ReferenceSlide');
add(slides, 'Blank', refSlide);

close(slides);
```

Чтобы использовать второй подход, укажите индекс, представляющий числовую позицию слайда. Например, используя шаблон PPT API по умолчанию, этот код делает pictureSlide второй слайд в презентации.

slides = Presentation('myPresentation');

titleSlide = add(slides,'Title Slide');
introSlide = add(slides,'Title and Content');
pictureSlide = add(slides,'Title and Picture',2);

Укажите образец слайдов

Шаблон может иметь несколько образцов слайдов. Два или более образца слайдов могут иметь дочерний макет слайдов с одинаковым именем. По умолчанию при указании макета слайдов с помощью PPT API используется первый макет слайдов с указанным именем. При указании образца слайдов в add укажите аргумент шаблона слайдов сразу после аргумента компоновки слайдов. Например, этот код использует Title Slide макет слайда, который является дочерним для myCustomMaster образец слайдов.

slides = Presentation('myPresentation');
titleSlide = add(slides,'Title Slide',myCustomMaster);

Документация