Документация

Объекты PPT

PPT API состоит из иерархического набора структур данных, известных как объекты, которые представляют представление и его содержимое. В верхней части иерархии имеется объект, представляющий представление. PPT API поддерживает список объектов, называемых нижестоящими элементами представления, которые представляют содержимое представления (слайды, абзацы, таблицы, изображения и т.д.). Каждый дочерний объект, в свою очередь, сохраняет список своего содержимого. Например, нижестоящие элементы объекта-таблицы являются объектами-строками, нижестоящие элементы объекта-строки являются объектами-вводами и т.д.

PPT API содержит функции (также известные как методы) для создания и сборки PPT-объектов, таких как абзацы и таблицы, и добавления объектов на слайды.

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

Чтобы создать файл презентации PowerPoint ®, используйте PPT API. Созданную презентацию можно открывать, просматривать и редактировать так же, как и любую другую презентацию PowerPoint.

Использование конструктора PPT

PPT API включает набор функций MATLAB ®, называемых конструкторами, которые используются для создания PPT-объектов различных типов.

Имя конструктора объекта - это имя класса MATLAB, из которого PPT API создает объект. Например, имя конструктора для объекта абзаца PPT - mlreportgen.ppt.Paragraph. Некоторые конструкторы не требуют аргументов. Другие конструкторы могут брать аргументы, которые обычно задают его начальное содержимое и свойства. Например, этот код создает объект абзаца, p, первоначальным содержанием которого является Slide 1.

p = mlreportgen.ppt.Paragraph('Slide 1');

Конструктор возвращает дескриптор создаваемому объекту. Назначение дескриптора переменной позволяет добавлять содержимое к объекту или задавать его свойства. Например, этот код добавляет содержимое к объекту абзаца p.

append(p,'-- In the Beginning');

Объекты PPT, созданные без конструкторов

Некоторые функции PPT API можно использовать для создания PPT-объектов без включения конструктора в код. Например, чтобы создать слайд, добавьте макет слайда в презентацию без mlreportgen.ppt.Slide конструктор. Этот код использует add метод для mlreportgen.ppt.Presentation объект slides. add метод создает Slide объект с именем slide1 на основе Title Slide макет в шаблоне PowerPoint API PPT по умолчанию.

import mlreportgen.ppt.*;
slides = Presentation('MySlides');

slide1 = add(slides,'Title Slide')

slide1 = 

  Slide with properties:

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