本页采用了机器翻译。点击此处可查看最新英文版本。

find

类: mlreportgen.ppt.Presentation
命名空间: mlreportgen.ppt

搜索演示文稿

全页展开

语法

searchResults = find(presentation,objectName)

说明

searchResults = find(presentation,objectName) 在指定的演示文稿中搜索 Name 属性值与 objectName 匹配的内容或幻灯片对象。

示例

示例

全部展开

打开实时脚本

导入 PPT 命名空间，这样您就不必对 PPT API 类使用长而完全限定的名称。

import mlreportgen.ppt.*

创建演示文稿。添加两张带有标题的幻灯片。

ppt = Presentation('myPresentation.pptx');
open(ppt);
add(ppt,'Title Slide');
add(ppt,'Title and Content');

查找 Name 属性为 Title 的演示文稿对象。

contents = find(ppt,'Title')
contents=1×2 object
  1×2 TextBoxPlaceholder array with properties:

    Bold
    Font
    ComplexScriptFont
    FontColor
    FontSize
    Italic
    Strike
    Subscript
    Superscript
    Underline
    BackgroundColor
    VAlign
    Name
    X
    Y
    Width
    Height
    Style
    Children
    Parent
    Tag
    Id

find 方法返回 mlreportgen.ppt.TextBoxPlaceholder 对象的 1×2 数组。第一个对象用于第一张幻灯片的标题，第二个对象用于第二张幻灯片的标题。

将第一张幻灯片中的标题替换为 My Presentation Title。 

p = Paragraph('My Presentation Title');
replace(contents(1),p);

关闭并查看演示文稿。

close(ppt);
rptview(ppt);

以下是生成的演示文稿：

输入参数

全部展开

要搜索的演示文稿，指定为 mlreportgen.ppt.Presentation 对象。

要搜索的 Name 属性值，指定为字符向量或字符串标量。

当您向演示文稿添加幻灯片时，add 方法会根据幻灯片布局设置幻灯片上内容对象的 Name 属性。请参阅 getLayoutNames。Name 属性值包括：

  • "Title"

  • "Content"

  • "Table"

  • "Picture"

  • "Text"

  • "Vertical Text"

Name 属性也可以设置为自定义值。

输出参量

全部展开

搜索结果，以内容或幻灯片对象数组的形式返回。该数组可以包含内容对象，例如：

该数组还可以包含 mlreportgen.ppt.Slide 对象。

版本历史记录

在 R2015b 中推出

另请参阅

|

主题