mlreportgen.ppt.TextBoxPlaceholder 类
命名空间: mlreportgen.ppt
幻灯片标题的占位符
描述
mlreportgen.ppt.TextBoxPlaceholder 类的对象是幻灯片标题的占位符。当您向演示文稿中添加带有标题的幻灯片时，PPT API 会为标题创建一个 TextBoxPlaceholder 对象。默认 PPT API 中的所有幻灯片布局（除 Blank 之外）都有标题。要查找 TextBoxPlaceholder 对象，请使用包含标题的幻灯片的 find 方法。然后，您可以设置 TextBoxPlaceholder 对象的属性来指定替换占位符内容的标题文本的默认格式。要用标题文本替换占位符内容，请使用 TextBoxPlaceholder 对象的 replace 方法。replace 方法不会替换 TextBoxPlaceholder 对象。它将文本作为一个或多个段落添加到 TextBoxPlaceholder 对象的 Children 属性。
mlreportgen.ppt.TextBoxPlaceholder 类是一个 handle 类。
属性
方法
示例
向演示文稿添加标题幻灯片，然后用标题和副标题文本替换标题和副标题的幻灯片占位符。
导入 PPT 命名空间，这样您就不必对 PPT API 类使用长而完全限定的名称。
import mlreportgen.ppt.*创建演示文稿。
ppt = Presentation("myTextBoxPlaceholderPresentation.pptx");
open(ppt);添加标题幻灯片。
slide = add(ppt,"Title Slide");使用幻灯片对象的 find 方法查找名为 Title 的占位符对象。
titlePlaceholderObj = find(slide,"Title")titlePlaceholderObj =
TextBoxPlaceholder with properties:
Bold: []
Font: []
ComplexScriptFont: []
FontColor: []
FontSize: []
Italic: []
Strike: []
Subscript: []
Superscript: []
Underline: []
BackgroundColor: []
VAlign: []
Name: 'Title'
X: '1524000emu'
Y: '1122363emu'
Width: '9144000emu'
Height: '2387600emu'
Style: []
Children: []
Parent: [1×1 mlreportgen.ppt.Slide]
Tag: 'ppt.TextBoxPlaceholder:431:407'
Id: '431:407'
find 方法返回一个 mlreportgen.ppt.TextBoxPlaceholder 对象。
用标题文本替换占位符内容。
replace(titlePlaceholderObj(1),"My Title");找到子标题的占位符对象。
subtitlePlaceholderObj = find(slide,"Subtitle")subtitlePlaceholderObj =
TextBoxPlaceholder with properties:
Bold: []
Font: []
ComplexScriptFont: []
FontColor: []
FontSize: []
Italic: []
Strike: []
Subscript: []
Superscript: []
Underline: []
BackgroundColor: []
VAlign: []
Name: 'Subtitle'
X: '1524000emu'
Y: '3602038emu'
Width: '9144000emu'
Height: '1655762emu'
Style: []
Children: []
Parent: [1×1 mlreportgen.ppt.Slide]
Tag: 'ppt.TextBoxPlaceholder:432:408'
Id: '432:408'
子标题的占位符对象也是一个 mlreportgen.ppt.TextBoxPlaceholder 对象。
将占位符内容替换为子标题文本。
replace(subtitlePlaceholderObj(1),"My Subtitle");关闭并查看演示文稿。
close(ppt); rptview(ppt);
这是生成的演示文稿中的标题幻灯片：
要向幻灯片标题添加段落，请使用代表标题的 add 对象的 TextBoxPlaceholder 方法。此示例创建一个带有 Title and Table 幻灯片的演示文稿，然后根据第一个演示文稿创建第二个演示文稿。在第二个演示文稿中，示例将内容添加到 Title and Table 幻灯片的标题中。
导入 PPT 命名空间，这样您就不必对 PPT API 类使用长而完全限定的名称。
import mlreportgen.ppt.*创建演示文稿并向演示文稿添加 Title and Table 幻灯片。
ppt = Presentation("myPPT1.pptx"); open(ppt); slide = add(ppt,"Title and Table");
找到标题的文本框占位符并替换内容。
contents = find(slide,"Title"); replace(contents(1),"Hello World");
关闭并生成演示文稿。
close(ppt);
这是生成的演示文稿中的标题幻灯片：
使用第一个演示文稿作为模板，创建第二个演示文稿。
ppt = Presentation("myPPT2.pptx","myPPT1.pptx"); open(ppt);
找到标题的文本框占位符并向标题添加内容。
contents = find(ppt,"Title"); add(contents(1)," -- How are You?");
关闭并查看演示文稿。
close(ppt); rptview(ppt)
在第二个演示文稿中，标题包含来自模板演示文稿的内容和添加的内容。
提示
如果您添加的幻灯片布局中包含非标题文本的占位符，则 PPT API 会创建
mlreportgen.ppt.BodyPlaceholder或mlreportgen.ppt.ContentPlaceholder对象。要查看 PPT API 为幻灯片对象创建的占位符对象，请查看幻灯片的
Children属性。例如，当您向演示文稿添加Title and Content幻灯片时，Children属性是一个包含mlreportgen.ppt.TextBoxPlaceholder对象和mlreportgen.ppt.ContentPlaceholder对象的数组。ppt = mlreportgen.ppt.Presentation("test.pptx"); open(ppt); slide = add(ppt,"Title and Content"); slide.Children(1)
ans = TextBoxPlaceholder with properties: Bold: [] Font: [] ComplexScriptFont: [] FontColor: [] FontSize: [] Italic: [] Strike: [] Subscript: [] Superscript: [] Underline: [] BackgroundColor: [] VAlign: [] Name: 'Title' X: [] Y: [] Width: [] Height: [] Style: [] Children: [] Parent: [1×1 mlreportgen.ppt.Slide] Tag: 'ppt.TextBoxPlaceholder:6:11' Id: '6:11'slide.Children(2)
ans = ContentPlaceholder with properties: Bold: [] Font: [] ComplexScriptFont: [] FontColor: [] FontSize: [] Italic: [] Strike: [] Subscript: [] Superscript: [] Underline: [] BackgroundColor: [] VAlign: [] Name: 'Content' X: [] Y: [] Width: [] Height: [] Style: [] Children: [] Parent: [1×1 mlreportgen.ppt.Slide] Tag: 'ppt.ContentPlaceholder:7:12' Id: '7:12'
版本历史记录
在 R2015b 中推出
