exponenta event banner

mlreportgen.ppt.Класс презентации

Пакет: 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 - Шаблон 97-2003 PowerPoint

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

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

Пример: "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 - Презентация PowerPoint 97-2003

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

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

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

Примечание

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

Пример: "myPresentation"

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

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

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

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

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

Методы

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

Примеры

свернуть все

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

Импортируйте пакет 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 свойство format.

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