主要内容

mlreportgen.ppt.ContentPlaceholder类

包:mlreportgen.ppt

幻灯片内容的占位符

在页面中全部展开

描述

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

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

  • 的标题和内容

  • 的两个内容

  • “比较”

  • 内容与标题的

找到一个的contentplaceholders对象,使用找到方法中包含内容占位符的幻灯片。方法将内容占位符替换为图片、表格或一个或多个段落取代的方法的contentplaceholders对象。对于一幅画或一张桌子取代方法取代了的contentplaceholders对象与一个mlreportgen.ppt.Picture或mlreportgen.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.w3.org/wiki/CSS/Properties/color/keywords．

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

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

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

  • px——像素(默认)

  • 厘米- - - - - -厘米

  • 在- - - - - -英寸

  • 毫米- - - - - -毫米

  • 个人电脑——异食癖

  • pt——分

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

文本是否使用斜体，指定为真正的或假．的设置真正的以斜体显示文本。

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

数据类型:逻辑

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

  • “单一”-单线水平线

  • “没有”-没有三击线

  • “双”-双水平线

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

是否将文本显示为下标，指定为真正的或假．的设置真正的将文本作为下标呈现。

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

数据类型:逻辑

是否将文本显示为上标，指定为真正的或假．的设置真正的将文本显示为上标。

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

数据类型:逻辑

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

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

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

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

  • 有关CSS颜色名称的列表，请参见https://www.w3.org/wiki/CSS/Properties/color/keywords．

  • 要指定十六进制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,“标题和内容”）;内容=找到(幻灯片,“内容”）;placeholderObj =内容(1);placeholderObj。风格= [placeholderObj.Style {Bold(true),FontColor(“红色”)});替换(placeholderObj“测试”）;

看到报告格式的方法．

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

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

此对象的父对象，指定为PPT对象。此属性是只读的。

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

标记用于此PPT API对象，指定为字符向量或字符串标量。在创建该对象时生成一个会话惟一标记。生成的标记具有表单类:ID,在那里类对象类是和ID是价值的Id属性。

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

方法

全部展开

例子

全部折叠

打开生活的脚本

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

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

进口mlreportgen.ppt。*

创建一个报告。

ppt =表示(“myContentPlaceholderPresentation.pptx”）;打开(ppt);

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

slide1 =添加(ppt,“标题和内容”）;

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

titlePlaceholderObj1 =找到(slide1,“标题”）;

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

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

替换(titlePlaceholderObj1“内容改为段落”）;

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

contentPlaceholderObj1 =找到(slide1,“内容”）;

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

用段落替换占位符内容。

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

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

slide2 =添加(ppt,“标题和内容”）;

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

titlePlaceholderObj2 =找到(slide2,“标题”）;替换(titlePlaceholderObj2“订单2魔方的内容替换为表格”）;

用表替换内容占位符。

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

添加第三张幻灯片标题和内容布局。

slide3 =添加(ppt,“标题和内容”）;

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

titlePlaceholderObj3 =找到(slide3,“标题”）;替换(titlePlaceholderObj3“内容换成辣椒的图片”）;

用图片替换内容占位符。

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

添加第四张幻灯片标题和内容布局。

slide4 =添加(ppt,“标题和内容”）;

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

titlePlaceholderObj4 =找到(slide4,“标题”）;替换(titlePlaceholderObj4“内容替换为多级列表”）;

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

greenTea =段(“绿茶”）;greenTea。FontColor=“绿色”；multilevelContent = {.．.“咖啡”，.．.“茶”，.．.｛.．.“红茶”，.．.greenTea,.．.}，.．.“牛奶”，.．.}；

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

contentPlaceholderObj4 =找到(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)
    [] Font: [] ComplexScriptFont: [] FontColor: [] FontSize:[]斜体:[]Strike:[]下标:[]上标:[]下划线:[]BackgroundColor: [] VAlign:[]名称:'Title' X: [] Y:[]宽度:[]高度:[]样式:[]儿童:[]家长:[]1×1 mlreport根.ppt。幻灯片)标签:“ppt。TextBoxPlaceholder: 6:11 Id:“6:11”

    slide.Children (2)
    [] Font: [] ComplexScriptFont: [] FontColor: [] FontSize:[]斜体:[]Strike:[]下标:[]上标:[]下划线:[]BackgroundColor: [] VAlign:[]名称:'Content' X: [] Y:[]宽度:[]高度:[]样式:[]Children: [] Parent: [] 1×1 mlreport根.ppt。幻灯片)标签:“ppt。内容Placeholder:7:12' Id: '7:12'

版本历史

介绍了R2015b

另请参阅

||||||||

主题

Baidu
map