mlreportgen.ppt.Presentation class

Пакет: mlreportgen.ppt

Создайте контейнер презентации Microsoft PowerPoint

Описание

Используйте объект mlreportgen.ppt.Presentation класс для создания PowerPoint® контейнер презентации.

The mlreportgen.ppt.Presentation класс является handle класс.

Атрибуты класса

ConstructOnLoad
true
HandleCompatible
true

Для получения информации об атрибутах класса см. раздел «Атрибуты класса».

Создание

Описание

presentationObj = mlreportgen.ppt.Presentation() создает контейнер презентации и устанавливает OutputPath свойство полного пути по умолчанию для выходного файла презентации. Путь по умолчанию является текущей папкой, а имя файла по умолчанию untitled. Для свойства TemplatePath задан полный путь шаблона PPT API по умолчанию.

пример

presentationObj = mlreportgen.ppt.Presentation(outputPath) создает контейнер презентации с OutputPath набор свойств установлен на outputPath.

пример

presentationObj = mlreportgen.ppt.Presentation(outputPath,templatePath) также устанавливает свойство TemplatePath на значение templatePath. Используйте этот синтаксис при необходимости использования пользовательского шаблона.

Если на outputPath и templatePath аргументы задают ту же презентацию, заданная презентация становится шаблоном для новой презентации. Когда создается новая презентация, она заменяет исходную презентацию.

Свойства

расширить все

Файл шаблона для этой презентации, заданный как вектор символов или строковый скаляр. Укажите путь и имя файла шаблона с расширением имени файла или без него. Путь может быть относительным или абсолютным. Если вы задаете имя файла без пути, файл должен находиться в текущей папке.

Эти расширения файлов не поддерживаются:

  • .ppt - Презентация 97-2003 PowerPoint

  • .pot - Шаблон 97-2003 PowerPoint

  • .pps - PowerPoint 97-2003 Показов

  • .xml - XML-презентация PowerPoint

Пример: "myTemplate.pptx"

Пример: "C:\myTemplates\myTemplate.pptx"

Выходной файл представления, заданный как вектор символов или строковый скаляр. Укажите путь и имя файла выходного файла представления с расширением имени файла или без него. Путь может быть относительным или абсолютным. Если вы задаете имя файла без пути, файл создается в текущей папке.

Файл может иметь одно из следующих расширений:

  • .pptx - Презентация PowerPoint

  • .pptm - Презентация с поддержкой макросов PowerPoint

  • .potx - Шаблон PowerPoint

  • .potm - Шаблон с поддержкой макросов PowerPoint

  • .ppsx - Показ PowerPoint

  • .ppsm - Показ с поддержкой макросов PowerPoint

Расширение сгенерированного файла презентации зависит от расширений, заданных TemplatePath и OutputPath свойства. В этой таблице показаны поддерживаемые комбинации.

OutputPath расширениеTemplatePath расширениеВыходное расширение
ничегоничего.pptx
.pptxничего.pptx
ничего.pptx.pptx
.pptx.pptx.pptx
none.potx.pptx
.potx.potx.potx
ничего.pptm.pptm
ничего.potm.pptm
.pptm.pptm.pptm
ничего.ppsx.ppsx
.ppsx.ppsx.ppsx
ничего.ppsm.ppsm
.ppsm.ppsm.ppsm

Эти расширения не поддерживаются ни для файла шаблона, ни для выхода файла презентации:

  • .ppt - Презентация 97-2003 PowerPoint

  • .pot - Шаблон 97-2003 PowerPoint

  • .pps - PowerPoint 97-2003 слайд- Показ

  • .xml - XML-презентация PowerPoint

Примечание

Задайте OutputPath свойство путем предоставления outputPath аргумент или установите OutputPath свойство перед открытием mlreportgen.ppt.Presentation объект. Когда Presentation открыт объект, расширение имени файла в OutputPath свойство обновляется на основе значений расширений в OutputPath и TemplatePath свойства, как описано в предыдущей таблице.

Пример: "myPresentation"

Пример: "C:\myPresentations\myPresentation.pptx"

Дочерние элементы этого объекта, заданные как массив ячеек объектов PPT. Это свойство доступно только для чтения.

ID для этого объекта PPT API, заданный как вектор символов или строковый скаляр. Уникальный для сеанса идентификатор генерируется как часть создания объекта. Можно задать идентификатор для замены сгенерированного идентификатора.

Тег для этого объекта PPT API, заданный как вектор символов или строковый скаляр. Тег, уникальный для сеанса, генерируется как часть создания этого объекта. Сгенерированный тег имеет форму CLASS:ID, где CLASS - класс объектов и ID - значение Id свойство объекта.

Установка собственного значения тега может помочь вам определить, где произошла проблема во время генерации презентации.

Методы

расширить все

Примеры

свернуть все

Когда Вы создаете контейнер представления и не определяете шаблон, шаблон, который идет с API PPT, определяет стиль по умолчанию слайдов. Стиль по умолчанию для отдельных слайдов можно переопределить с помощью свойств формата и объектов.

Импортируйте пакет PPT, чтобы не использовать длинные, полные имена для классов PPT API.

import mlreportgen.ppt.*

Создайте mlreportgen.ppt.Presentation объект, содержащий слайды. Не указывайте шаблон. Добавить слайд для заголовка и слайд для текста.

ppt = Presentation('myFirstPresentation.pptx');
open(ppt);

titleSlide = add(ppt,'Title Slide');
textSlide  = add(ppt,'Title and Content');

Укажите заголовок презентации. Сделать заголовок красным, создав заголовок как mlreportgen.ppt.Paragraph объект и установка FontColor формат.

paraObj = Paragraph('My First Presentation');
paraObj.FontColor = 'red';
replace(titleSlide,'Title',paraObj);

Добавить содержимое на второй слайд.

replace(textSlide,'Content',{'Subject A','Subject B','Subject C'});

Закройте и просмотрите презентацию.

close(ppt);
rptview(ppt);

Вот сгенерированная презентация:

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

Создайте копию шаблона PPT API по умолчанию с именем myTemplate.

mlreportgen.ppt.Presentation.createTemplate('myTemplate.pptx');

В PowerPoint настройте форматирование шаблонов слайдов и размещений слайдов в myTemplate.pptx. См. раздел Настройка шаблона презентации PowerPoint.

Сгенерируйте презентацию с именем myPresentation использование шаблона myTemplate.

import mlreportgen.ppt.*
ppt = Presentation('myPresentation.pptx','myTemplate.pptx');
open(ppt);
slide = add(ppt,'Title Slide');
replace(slide,'Title','My Title');
close(ppt);
rptview(ppt);
Введенный в R2015a
Для просмотра документации необходимо авторизоваться на сайте