mlreportgen.ppt.Presentation class

Пакет: mlreportgen.ppt
Суперклассы:

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

Описание

Создает представление Microsoft® PowerPoint®.

Конструкция

presentationObj = Presentation() создает представление под названием Untitled.pptx в текущей папке, с помощью API PPT по умолчанию default.pptx шаблон.

presentationObj = Presentation(presentationPath) создает представление в заданном местоположении.

presentationObj = Presentation(presentationPath,templatePath) создает представление с помощью шаблона PowerPoint в заданном местоположении.

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

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

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

  • .potx — Шаблон PowerPoint

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

  • .ppsx — Слайд-шоу PowerPoint

  • .ppsm — PowerPoint макро-Enabled слайд-шоу

presentationPath расширениеtemplatePath расширениеВыведите расширение
'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

Входные параметры

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

Путь к файлу презентации в виде вектора символов.

Путь к шаблону PowerPoint для представления в виде вектора символов.

Выходные аргументы

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

Объект представления, возвращенный как mlreportgen.ppt.Presentation объект

Свойства

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

Путь к шаблону PowerPoint, чтобы использовать в этом элементе представления в виде вектора символов.

Вы устанавливаете это свойство только, прежде чем вы откроете представление.

Путь этого выходного файла представления в виде вектора символов.

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

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

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

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

Методы

Метод

Цель

open

Открытое представление.

close

Закройте представление.

find

Поиск в представлении.

Используйте Presentation.find метод тем же путем вы используете Slide.find метод.

replace

Содержимое замены в представлении.

add

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

getMasterNames

Получите имена мастеров слайдов для представления

getLayoutNames

Получите имена размещений для представления.

getTableStyleNames

Получите имена стиля таблицы для представления.

Примеры

свернуть все

Создайте представление с тремя слайдами. Используйте шаблон представления PPT по умолчанию.

import mlreportgen.ppt.*

slides = Presentation('myFirstPresentation');

add(slides,'Title Slide');
add(slides,'Title and Content');
add(slides,'Title and Picture');

Исследуйте слайды Presentation объект.

slides
slides = 

  Presentation with properties:

    TemplatePath: 'matlab/toolbox/shared/mlreportgen/ppt/resources/...'
      OutputPath: 'myFirstPresentation.pptx'
        Children: [1x3 mlreportgen.ppt.Slide]
          Parent: []
             Tag: 'ppt.Presentation:1181'
              Id: '1181'

Исследуйте первое понижение.

slides.Children(1)
ans = 

  Slide with properties:

         Layout: 'Title Slide'
    SlideMaster: 'Office Theme'
           Name: ''
          Style: []
       Children: [1x2 mlreportgen.ppt.TextBoxPlaceholder]
         Parent: [1x1 mlreportgen.ppt.Presentation]
            Tag: 'ppt.Slide:1183'
             Id: '1183'

Задайте заголовок для представления. Найдите Title заполнитель в первом понижении и предоставляет заголовок. Сделайте заголовок красным.

contents = find(slides,'Title');
replace(contents(1),'My First Presentation');
contents(1).FontColor = 'red';

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

contents = find(slides,'Content');
replace(contents,{'Subject A','Subject B','Subject C'});

Закройте представление, чтобы сгенерировать выход.

close(slides);

Открытый myFirstPresentation.pptx. На платформе Windows® можно открыть представление в MATLAB®:

if ispc
    winopen(slidesFile);
end

Создайте представление с использованием myFirstPresentation представление как шаблон (см. предыдущий пример).

import mlreportgen.ppt.*

slides = Presentation('mySecondPresentation','myFirstPresentation');

Измените заголовок на My Second Presentation.

contents = find(slides,'Title');
replace(contents(1),'My Second Presentation');

Закройте представление, чтобы сгенерировать выход.

close(slides);

Открытый mySecondPresentation.pptx. На платформе Windows можно открыть представление в MATLAB:

if ispc
    winopen(slidesFile);
end

Введенный в R2015b