PPT API использует презентации PowerPoint ® в качестве шаблонов для создания презентаций. Шаблоны позволяют задать фиксированное содержимое, макет по умолчанию и внешний вид слайдов в презентациях. Программа MATLAB ® может использовать PPT API для переопределения формата по умолчанию и формата определенных слайдов.
Шаблон может быть пустой презентацией или презентацией с слайдами. В качестве шаблонов для презентации PPT API можно использовать следующее:
Шаблон PowerPoint API PPT по умолчанию
Пользовательская копия шаблона PowerPoint API PPT по умолчанию
Существующая презентация PowerPoint, содержимое которой необходимо обновить
Шаблон PowerPoint, создаваемый или обновляемый в интерактивном режиме в PowerPoint
См. раздел Настройка шаблона презентации PowerPoint.
Шаблоны PowerPoint содержат несколько элементов, которые API PPT использует для создания презентации. Чтобы настроить форматирование, определенное в шаблоне, измените один или несколько из этих элементов шаблона.
| Элемент шаблона PowerPoint | Цель |
|---|---|
Образцы слайдов | Глобально применяет форматирование образца слайдов к презентации. Задает макет и форматы, общие для набора макетов слайдов |
Раскладки слайдов | Задает вариант макета образца слайдов. |
Стили таблиц | Задает внешний вид таблицы по умолчанию. PowerPoint определяет стандартный набор стилей таблиц. Эти стили нельзя изменить, но можно использовать PPT API для применения этих стилей к создаваемым таблицам и переопределения стилей для определенных таблиц. |
Заполнители | Указывает область листа слайдов, которую можно заменить текстом, списком, изображением, таблицей или другим содержимым. Каждый местозаполнитель имеет имя. Для назначения имени местозаполнителю можно использовать PowerPoint в интерактивном режиме. Затем можно использовать имя в PPT-программе для замены заполнителя содержимым. |
Шаблон PowerPoint может содержать несколько образцов слайдов. Образец слайдов может иметь дочерний макет слайдов, имя которого совпадает с именем дочернего макета слайдов в другом шаблоне слайдов. При использовании PPT API, если шаблон имеет несколько шаблонов слайдов, необходимо знать имя шаблона слайдов, чтобы можно было указать правильный макет слайдов. Имя можно узнать в PowerPoint или с помощью API.
Можно переименовать шаблон, чтобы определить его назначение. Переименовать образец слайдов можно только в PowerPoint.
В PowerPoint выберите «Вид» > «Образец слайдов».
На панели компоновки слайдов наведите курсор на образец слайдов. Образцы слайдов нумеруются и находятся на верхнем уровне древовидной иерархии. В подсказке отображается имя. На этом рисунке Office Theme - имя, используемое в API. Не включать текст Slide Master.
Если требуется переименовать образец, на вкладке «Образец слайдов» в разделе «Редактирование шаблона» нажмите кнопку «Переименовать» и следуйте инструкциям.
Чтобы просмотреть имена шаблонов слайдов с помощью PPT API, используйте getMasterNames метод с помощью mlreportgen.ppt.Presentation объект. В этом примере используется шаблон PowerPoint API PPT по умолчанию, имеющий один образец слайдов.
import mlreportgen.ppt.*; slides = Presentation('myPresentation'); getMasterNames(slides);
ans =
'Office Theme'Чтобы добавить слайд с помощью PPT API, необходимо знать имя макетов слайдов в шаблоне PowerPoint. Имя формата слайдов можно узнать в PowerPoint и с помощью API.
При добавлении слайд-макета его можно переименовать, чтобы определить его назначение. Макет слайдов можно переименовать только в PowerPoint.
В PowerPoint выберите «Вид» > «Образец слайдов».
На панели макетов слайдов наведите курсор на макет слайдов в шаблоне слайдов. Всплывающая подсказка отображает имя листа слайдов. На этом рисунке Title Slide - имя, используемое в API. Не включать текст Layout.
Если требуется переименовать макет слайдов, на вкладке «Образец слайдов» в разделе «Редактирование шаблона» нажмите кнопку «Переименовать» и следуйте инструкциям.
Чтобы просмотреть имена макетов слайдов с помощью PPT API, используйте Presentation.getLayoutNames способ. Перед получением имен макетов необходимо получить имя образца слайдов. PPT API возвращает шаблоны слайдов в виде массива ячеек. В этом примере используется шаблон PPT API PowerPoint по умолчанию для получения макетов слайдов из первого шаблона в шаблоне.
import mlreportgen.ppt.*; slides = Presentation('myPresentation'); masters = getMasterNames(slides); layouts = getLayoutNames(slides,masters{1}); layouts
Columns 1 through 5 'Title Slide' 'Title and Vertica…' 'Vertical Title an…' 'Title and Table' 'Title and Picture' Columns 6 through 11 'Title and Content' 'Section Header' 'Two Content' 'Comparison' 'Title Only' 'Blank' Columns 12 through 13 'Content with Capt…' 'Picture with Capt…'
Необходимо знать имена местозаполнителей, чтобы использовать PPT API для замены местозаполнителей содержимым. Имя местозаполнителя можно найти с помощью PowerPoint или PPT API.
Можно переименовать местозаполнитель, чтобы определить его назначение.
В PowerPoint выберите «Вид» > «Образец слайдов».
На вкладке Главная в разделе Правка выберите Выбрать > Область выбора.
На панели компоновки слайдов выберите макет, содержащий местозаполнитель содержимого, имя которого требуется просмотреть. Имена местозаполнителей, используемых в раскладке слайдов, отображаются на панели «Выбор». Щелкните в местозаполнителе содержимого, чтобы выделить имя на панели выбора.
На рисунке показано, что имя заполнителя содержимого в раскладке слайдов «Заголовок» и «Содержимое»: Content.
Если требуется переименовать местозаполнитель, щелкните имя на панели «Выбор» и введите новое имя.
При обновлении содержимого в презентации PowerPoint для просмотра имени объектов содержимого на этом слайде также используйте область выбора. Например:
Создание и создание презентации на слайде с таблицей.
import mlreportgen.ppt.* slidesFile = 'myTablePresentation.pptx'; slides = Presentation(slidesFile); slide1 = add(slides,'Blank'); add(slide1,Table(magic(5))); close(slides); if ispc winopen(slidesFile); end
В PowerPoint откройте панель «Выбор». Имя таблицы представляет собой сгенерированную строку символов. Его можно переименовать и использовать новое имя с помощью PPT API.
