Main Content

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

replace

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

替换幻灯片中的文本、表格或图片

全页展开

语法

replace(slide,contentName,content)

说明

示例

replace(slide,contentName,content) 用指定的内容替换幻灯片内容对象中现有的内容，指定的内容可以是一个或多个段落、一个表格或一张图片。如果您在 content 参量中指定的内容类型对于 contentName 标识的内容对象无效，则 replace 方法无效。

示例

全部展开

打开实时脚本

使用 mlreportgen.ppt.Slide 对象的 replace 方法将占位符内容替换为您的内容。

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

import mlreportgen.ppt.*

创建演示文稿。添加用于文本的幻灯片、用于图片的幻灯片和用于表格的幻灯片。

ppt = Presentation('mySlideReplacePresentation.pptx');
slide1 = add(ppt,'Title and Content');
slide2 = add(ppt,'Title and Picture');
slide3 = add(ppt,'Title and Table');

在第一张幻灯片中，用文本替换 Title 和 Content 占位符。

replace(slide1,'Title','Text Slide');
replace(slide1,'Content','This is the content for slide 1');

在第二张幻灯片中，将 Title 占位符替换为文本，将 Picture 占位符替换为图片。

replace(slide2,'Title','Picture Slide');
replace(slide2,'Picture',Picture('b747.jpg'));

在第三张幻灯片中，将 Title 占位符替换为文本，将 Table 占位符替换为表格。

replace(slide3,'Title','Table Slide');
replace(slide3,'Table',Table({1 2; 'a' 'b'}));

关闭并查看演示文稿。

close(ppt);
rptview(ppt);

以下是生成的演示文稿：

输入参数

全部展开

要替换内容的幻灯片，指定为 mlreportgen.ppt.Slide 对象。

包含要替换的内容的对象的 Name 属性值，指定为字符向量或字符串标量。

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

  • 'Title'

  • 'Content'

  • 'Table'

  • 'Picture'

  • 'Text'

  • 'Vertical Text'

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

替换内容，指定为以下值之一：

  • 字符向量或字符串标量

  • mlreportgen.ppt.Paragaph 对象

  • 字符串数组

  • mlreportgen.ppt.Table 对象

  • mlreportgen.ppt.Picture 对象

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

版本历史记录

在 R2015b 中推出

另请参阅

主题