主要内容

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

replace

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

替换内容占位符或内容

说明

replacementContentObj = replace(contentPlaceholder,content) 替换 ContentPlaceholder 对象的内容或者替换 ContentPlaceholder 对象。如果 content 参量是一个段落,则 replace 方法会通过使该段落成为 ContentPlaceholder 对象的子对象来替换 ContentPlaceholder 的内容。如果 content 参量是图片或表,则 replace 方法分别用 mlreportgen.ppt.Picturemlreportgen.ppt.Table 对象替换 ContentPlaceholder 对象。

示例

replace(contentPlaceholder,paragraphs) 用多个段落替换内容占位符的内容。

示例

全部展开

在演示文稿中添加四张 Title and Content 幻灯片。将第一张幻灯片的内容占位符替换为文本,第二张幻灯片的内容占位符替换为表,第三张幻灯片的内容占位符替换为图片,第四张幻灯片的内容占位符替换为多级列表。

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

import mlreportgen.ppt.*

创建演示文稿。

ppt = Presentation("myContentPlaceholderPresentation.pptx");
open(ppt);

添加具有 Title and Content 布局的幻灯片。

slide1 = add(ppt,"Title and Content");

使用幻灯片对象的 find 方法查找名为 Title 的占位符对象。

titlePlaceholderObj1 = find(slide1,"Title");

find 方法返回一个 mlreportgen.ppt.TextBoxPlaceholder 对象。

用标题文本替换占位符内容。

replace(titlePlaceholderObj1,"Content Replaced with Paragraph");

使用幻灯片对象的 find 方法查找名为 Content 的占位符对象。

contentPlaceholderObj1 = find(slide1,"Content");

find 方法返回一个 mlreportgen.ppt.ContentPlaceholder 对象。

用段落替换占位符内容。

replace(contentPlaceholderObj1,Paragraph("This is my paragaph"));

添加具有 Title and Content 布局的第二张幻灯片。

slide2 = add(ppt,"Title and Content");

用标题文本替换标题的占位符。

titlePlaceholderObj2 = find(slide2,"Title");
replace(titlePlaceholderObj2,"Content Replaced with Table for Order 2 Magic Square");

用表替换内容占位符。

contentPlaceholderObj2 = find(slide2,"Content");
replace(contentPlaceholderObj2,Table(magic(2)));

添加具有 Title and Content 布局的第三张幻灯片。

slide3 = add(ppt,"Title and Content");

用标题文本替换标题的占位符。

titlePlaceholderObj3 = find(slide3,"Title");
replace(titlePlaceholderObj3,"Content Replaced with Picture of Peppers");

用图片替换内容占位符。

contentPlaceholderObj3 = find(slide3,"Content");
replace(contentPlaceholderObj3,Picture("peppers.png"));

添加具有 Title and Content 布局的第四张幻灯片。

slide4 = add(ppt,"Title and Content");

用标题文本替换标题的占位符。

titlePlaceholderObj4 = find(slide4,"Title");
replace(titlePlaceholderObj4,"Content Replaced with a Multilevel List");

为多级列表创建内容。您可以将多级列表表示为包含一个或多个表示子列表的元胞数组的元胞数组。使用 mlreportgen.ppt.Paragraph 对象来格式化列表中的项目。

greenTea = Paragraph("Green Tea");
greenTea.FontColor = "green";

multilevelContent = { ...
    "Coffee", ...
    "Tea", ...
    { ...
        "Black Tea", ...
        greenTea, ...
    }, ...
    "Milk", ...
    };

用多级列表内容替换 Content 占位符。

contentPlaceholderObj4 = find(slide4,"Content");
replace(contentPlaceholderObj4,multilevelContent);

关闭并查看演示文稿。

close(ppt);
rptview(ppt);

以下是生成的幻灯片:

输入参数

全部展开

内容占位符,指定为 mlreportgen.ppt.ContentPlaceholder 对象。

用作替换的内容,指定为字符向量、字符串标量或以下对象之一:

用于替换的多个段落,指定为以下值之一:

  • 字符串数组

  • 由字符串标量、字符向量或 mlreportgen.ppt.Paragraph 对象的任意组合组成的元胞数组。内部数组相对于外部数组缩进。

幻灯片布局决定文本是否显示为段落、项目符号列表项还是编号列表项。

输出参量

全部展开

替换内容,以 mlreportgen.ppt.Paragraphmlreportgen.ppt.Picturemlreportgen.ppt.Table 对象形式返回。

版本历史记录

在 R2015b 中推出