主要内容

mlreportgen.ppt.ContentPlaceholder类

包:mlreportgen.ppt

幻灯片内容的占位符

描述

的对象mlreportgen.ppt.ContentPlaceholder类表示幻灯片中的内容占位符。您可以用图片、表格或一个或多个段落替换内容占位符。

PPT API创建一个的contentplaceholders当向演示文稿添加幻灯片且幻灯片布局具有内容占位符时,对象。在默认的PPT API中,这些布局有一个或多个内容占位符:

  • “标题及内容”

  • 的两个内容

  • “比较”

  • “内容附标题”

为了找到一个的contentplaceholders对象时,使用找到包含内容占位符的幻灯片的方法。要将内容占位符替换为图片、表格或一个或多个段落,请使用取代方法的contentplaceholders对象。对于图片或表格,使用取代方法替换的contentplaceholders对象的mlreportgen.ppt.Picturemlreportgen.ppt.Table对象,分别。对于段落,PPT API不能取代的contentplaceholders对象。它增加了mlreportgen.ppt.Paragraph对象的子对象的contentplaceholders对象。

当你替换的contentplaceholders对象的表格图片对象,有些的contentplaceholders对象属性不适用于替换内容。详细信息请参见属性

请注意

如果将内容占位符替换为图片,微软®演示文稿®调整内容占位符的大小以适应图片的大小。如果您希望在幻灯片中固定占位符的位置和大小,请使用带有图片占位符的幻灯片。看到mlreportgen.ppt.PicturePlaceholder

mlreportgen.ppt.ContentPlaceholder类是一个处理类。

类属性

HandleCompatible
真正的
ConstructOnLoad
真正的

有关类属性的信息,请参见类属性

属性

全部展开

文本是否使用粗体,指定为真正的.设置真正的以粗体显示文本。设置使用常规权重文本。

此属性仅在用文本替换内容占位符的内容时应用。

数据类型:逻辑

文本的字体族,指定为字符向量或字符串标量。中显示在字体列表中的字体微软演示文稿.要查看字体列表,在PowerPoint中,在首页选项卡,在字体组中,单击字体右侧的箭头。

此属性仅在用文本替换内容占位符的内容时应用。

用于复杂脚本的字体族,指定为字符向量或字符串标量。在需要复杂脚本(如阿拉伯语或亚洲语)来呈现文本的地区进行替换时,指定要使用的字体系列。

此属性仅在用文本替换内容占位符的内容时应用。

文本的字体颜色,指定为字符向量或由CSS颜色名称或十六进制RGB值组成的字符串标量。

  • 有关CSS颜色名称的列表,请参见https://www.crockford.com/wrrrld/color.html

  • 若要指定十六进制RGB格式,请使用作为红色、绿色和蓝色值的第一个字符和两位十六进制数字。例如,“# 0000 ff”指定的蓝色。

此属性仅在用文本替换内容占位符的内容时应用。

文本的字体大小,指定为字符向量或字符串标量,由一个数字后跟一个测量单位组成。例如,“11 pt”指定11个点。有效的缩写有:

  • px-像素(默认值)

  • 厘米- - - - - -厘米

  • - - - - - -英寸

  • 毫米- - - - - -毫米

  • 个人电脑——异食癖

  • pt——分

此属性仅在用文本替换内容占位符的内容时应用。

文本是否使用斜体,指定为真正的.设置真正的以斜体显示文本。

此属性仅在用文本替换内容占位符的内容时应用。

数据类型:逻辑

文本的删除线样式,指定为以下值之一:

  • “单一”-单条水平线

  • “没有”-没有三振线

  • “双”-双水平线

此属性仅在用文本替换内容占位符的内容时应用。

是否将文本显示为下标,指定为真正的.设置真正的将文本作为下标呈现。

此属性仅在用文本替换内容占位符的内容时应用。

数据类型:逻辑

是否将文本显示为上标,指定为真正的.设置真正的将文本显示为上标。

此属性仅在用文本替换内容占位符的内容时应用。

数据类型:逻辑

文本的下划线样式,指定为以下值之一:

价值 描述
“单一” 单下划线
“双” 双下划线
“重” 厚的下划线
“词” 只有下划线的单词(不是空格)
“点” 点强调
“dottedheavy” 粗点下划线
“冲” 冲下划线
“dashheavy” 粗的虚线下划线
“dashlong” 长虚线下划线
“dashlongheavy” 粗,长,虚线下划线
“dotdash” 点划下划线
“dotdashheavy” 厚厚的点破折号下划线
“dotdotdash” Dot-dot-dash下划线
“dotdotdashheavy” 厚厚的点。点。破折号下划线
“波浪” 波浪下划线
“wavyheavy” 厚厚的波浪状下划线
“wavydouble” 波浪,双下划线
“没有” 没有强调

此属性仅在用文本替换内容占位符的内容时应用。

内容占位符的背景颜色,指定为由CSS颜色名称或十六进制RGB值组成的字符向量或字符串标量。

  • 有关CSS颜色名称的列表,请参见https://www.crockford.com/wrrrld/color.html

  • 若要指定十六进制RGB格式,请使用作为红色、绿色和蓝色值的第一个字符和两位十六进制数字。例如,“# 0000 ff”指定的蓝色。

此属性仅在用文本替换内容占位符的内容时应用。

内容占位符中文本的垂直对齐,指定为字符向量或字符串标量。在表中指定一个值。

价值 描述

“高级”

垂直对齐到内容占位符的顶部

“底”

垂直对齐到内容占位符的底部

“中间”

垂直对齐到内容占位符的中间

“topCentered”

垂直对齐到顶部,水平对齐到内容占位符的中心

“bottomCentered”

垂直对齐到底部,水平对齐到内容占位符的中心

“middleCentered”

垂直对齐到中间,水平对齐到内容占位符的中心

此属性仅在用文本替换内容占位符的内容时应用。

内容占位符名称,指定为字符向量或字符串标量。

左上角x内容占位符在幻灯片中的位置坐标,指定为字符向量或字符串标量,由一个数字后跟一个测量单位组成。例如,'5in'指定5英寸。有效的缩写有:

  • px-像素(默认值)

  • 厘米- - - - - -厘米

  • - - - - - -英寸

  • 毫米- - - - - -毫米

  • 个人电脑——异食癖

  • pt——分

左上角y内容占位符在幻灯片中的位置坐标,指定为字符向量或字符串标量,由一个数字后跟一个测量单位组成。例如,'5in'指定5英寸。有效的缩写有:

  • px-像素(默认值)

  • 厘米- - - - - -厘米

  • - - - - - -英寸

  • 毫米- - - - - -毫米

  • 个人电脑——异食癖

  • pt——分

内容占位符的宽度,指定为字符向量或字符串标量,由数字后跟度量单位的缩写组成。例如,'5in'指定5英寸。有效的缩写有:

  • px-像素(默认值)

  • 厘米- - - - - -厘米

  • - - - - - -英寸

  • 毫米- - - - - -毫米

  • 个人电脑——异食癖

  • pt——分

当内容占位符替换为图片时,此属性不应用。

内容占位符的高度,指定为字符向量或字符串标量,由数字后跟度量单位的缩写组成。例如,'5in'指定5英寸。有效的缩写有:

  • px-像素(默认值)

  • 厘米- - - - - -厘米

  • - - - - - -英寸

  • 毫米- - - - - -毫米

  • 个人电脑——异食癖

  • pt——分

当内容占位符替换为图片时,此属性不应用。

内容占位符格式化,指定为单元格数组的PPT格式对象。

属性的现有值连接来添加格式对象风格属性,该单元格数组包含要添加的格式对象。例如:

进口mlreportgen.ppt。*ppt =演示文稿(“我的报告”);幻灯片=添加(ppt,“标题及内容”);内容= find(幻灯片,“内容”);placeholderObj = content(1);placeholderObj。风格= [placeholderObj.Style {Bold(true),FontColor(“红色”)});替换(placeholderObj“测试”);

看到演示文稿格式方法

此属性仅在用文本替换内容占位符的内容时应用。

此对象的子元素,指定为PPT对象的单元格数组。此属性是只读的。

此对象的父对象,指定为一个PPT对象。此属性是只读的。

此PPT API对象的ID,指定为字符向量或字符串标量。会话唯一ID作为对象创建的一部分生成。您可以指定一个ID来替换生成的ID。

标记,指定为字符向量或字符串标量。会话唯一标记是在创建此对象时生成的。生成的标记具有表单类:ID,在那里对象类是和吗ID是值Id对象的属性。

指定您自己的标记值可以帮助您确定在表示生成过程中发生问题的位置。

方法

全部展开

例子

全部折叠

添加四个标题及内容幻灯片到演示文稿。将第一张幻灯片的内容占位符替换为文本,第二张幻灯片替换为表格,第三张幻灯片替换为图片,第四张幻灯片替换为多层列表。

导入PPT包,这样就不必为PPT API类使用长且完全限定的名称。

进口mlreportgen.ppt。*

创建一个演示文稿。

ppt =演示文稿(“myContentPlaceholderPresentation.pptx”);打开(ppt);

添加一个幻灯片标题及内容布局。

Slide1 = add(ppt,“标题及内容”);

使用找到方法查找具有该名称的占位符对象标题

titlePlaceholderObj1 = find(slide1,“标题”);

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

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

替换(titlePlaceholderObj1“内容被段落取代”);

使用找到方法查找具有该名称的占位符对象内容

contentPlaceholderObj1 = find(slide1,“内容”);

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

将占位符内容替换为段落。

替换(contentPlaceholderObj1段("这是我的段落"));

添加第二张幻灯片标题及内容布局。

Slide2 = add(ppt,“标题及内容”);

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

titlePlaceholderObj2 = find(slide2,“标题”);替换(titlePlaceholderObj2“订单2魔方内容替换为表格”);

将内容占位符替换为表。

contentPlaceholderObj2 = find(slide2,“内容”);替换(contentPlaceholderObj2表(魔法(2)));

用a添加第三张幻灯片标题及内容布局。

Slide3 = add(ppt,“标题及内容”);

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

titlePlaceholderObj3 = find(slide3,“标题”);替换(titlePlaceholderObj3“内容替换为辣椒图片”);

将内容占位符替换为图片。

contentPlaceholderObj3 = find(slide3,“内容”);替换(contentPlaceholderObj3、图片(“peppers.png”));

用a添加第四张幻灯片标题及内容布局。

Slide4 = add(ppt,“标题及内容”);

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

titlePlaceholderObj4 = find(slide4,“标题”);替换(titlePlaceholderObj4“内容被多层列表替换”);

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

greenTea =段落(“绿茶”);greenTea。FontColor=“绿色”;multilevelContent = {...“咖啡”...“茶”......“红茶”...greenTea,...},...“牛奶”...};

取代内容具有多层列表内容的占位符。

contentPlaceholderObj4 = find(slide4,“内容”);替换(contentPlaceholderObj4 multilevelContent);

关闭并查看演示文稿。

关闭(ppt);rptview (ppt);

下面是生成的幻灯片:

提示

  • 当您替换演示文稿中的占位符内容,然后将该演示文稿用作新演示文稿的模板时,PPT API为新演示文稿中的内容创建的对象取决于内容的类型,如表所示。

    替换内容 新表示中的对象类
    图片 mlreportgen.ppt.TemplatePicture
    表格 mlreportgen.ppt.TemplateTable
    mlreportgen.ppt.ContentPlaceholder

    有关更多信息,请参见添加和替换表示内容

  • 若要查看PPT API为幻灯片对象创建的占位符对象,请查看孩子们属性。例如,当你添加一个标题及内容滑动到演示文稿孩子们属性的数组mlreportgen.ppt.TextBoxPlaceholder对象和mlreportgen.ppt.ContentPlaceholder对象。

    ppt = mlreportgen.ppt.Presentation(“test.pptx”);打开(ppt);幻灯片=添加(ppt,“标题及内容”);slide.Children (1)
    ans =带有属性的TextBoxPlaceholder:粗体:[]字体:[]ComplexScriptFont: [] FontColor: [] FontSize:[]斜体:[]斜体:[]下标:[]上标:[]下划线:[]BackgroundColor: [] VAlign:[]名称:'Title' X: [] Y:[]宽度:[]高度:[]样式:[]儿童:[]家长:[1×1 mlreportgen.ppt。标签:'ppt。TextBoxPlaceholder:6:11' Id: '6:11'

    slide.Children (2)
    ans =带有属性的ContentPlaceholder:粗体:[]字体:[]ComplexScriptFont: [] FontColor: [] FontSize:[]斜体:[]斜体:[]下标:[]上标:[]下划线:[]BackgroundColor: [] VAlign:[]名称:'Content' X: [] Y:[]宽度:[]高度:[]样式:[]儿童:[]家长:[1×1 mlreportgen.ppt。标签:'ppt。内容Placeholder:7:12' Id: '7:12'
在R2015b中引入