mlreportgen.ppt.Presentation class

Пакет: mlreportgen.ppt

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

Описание

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

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 — PowerPoint 97–2003 представления

  • .pot — PowerPoint 97–2003 шаблона

  • .pps — PowerPoint 97–2003 показывает

  • .xml — PowerPoint представление XML

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

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

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

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

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

  • .pptm — PowerPoint макро-Enabled представление

  • .potx — Шаблон PowerPoint

  • .potm — PowerPoint макро-Enabled шаблон

  • .ppsx — PowerPoint показывает

  • .ppsm — PowerPoint макро-Enabled показ

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

OutputPath расширениеTemplatePath расширениеВыведите расширение
'none''none'.pptx
.pptx'none'.pptx
'none'.pptx.pptx
.pptx.pptx.pptx
none.potx.pptx
.potx.potx.potx
'none'.pptm.pptm
'none'.potm.pptm
.pptm.pptm.pptm
'none'.ppsx.ppsx
.ppsx.ppsx.ppsx
'none'.ppsm.ppsm
.ppsm.ppsm.ppsm

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

  • .ppt — PowerPoint 97–2003 представления

  • .pot — PowerPoint 97–2003 шаблона

  • .pps — PowerPoint 97–2003 слайд-шоу

  • .xml — PowerPoint представление XML

Примечание

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

Пример: "myPresentation"

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

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

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

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

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

Методы

развернуть все

Примеры

свернуть все

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

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

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);

Вот сгенерированное представление:

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

Создайте копию шаблона значения по умолчанию API PPT, названного 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