PPT 对象

PPT API 由一组分层的数据结构（称为对象）组成，它们代表演示文稿及其内容。层次结构的顶部有一个代表演示文稿的对象。PPT API 维护一个对象列表，称为演示子项，代表演示内容（幻灯片、段落、表格、图片等）。每个子对象依次维护其内容的列表。例如，表对象的子对象是其行对象，行对象的子对象是其条目对象，等等。

PPT API 包含用于创建和组装 PPT 对象（例如段落和表格）并将对象添加到幻灯片的函数（也称为方法）。

PPT API 包括格式对象，例如粗体和字体颜色对象，您可以使用它们来定义演示元素的格式。

要生成 PowerPoint^® 演示文稿文件，请使用 PPT API。您可以像任何其他 PowerPoint 演示文稿一样打开、查看和编辑生成的演示文稿。

使用 PPT 构造器

PPT API 包括一组 MATLAB^® 函数，称为构造函数，您可以使用它们来创建各种类型的 PPT 对象。

对象构造函数的名称是 PPT API 从中创建对象的 MATLAB 类的名称。例如 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 构造函数的演示文稿中。此代码对 mlreportgen.ppt.Presentation 对象 slides 使用了 add 方法。add 方法根据默认 PPT API PowerPoint 模板中的 Title Slide 布局，创建一个名为 slide1 的 Slide 对象。

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

slide1 = add(ppt,'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'