主要内容

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

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 类。

类属性

HandleCompatible
true
ConstructOnLoad
true

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

属性

全部展开

文本的字体系列,指定为字符向量或字符串标量。指定 Microsoft® PowerPoint® 中的字体列表中出现的字体。要查看字体列表,请在 PowerPoint 的主页选项卡上的字体组中点击字体右侧的箭头。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

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

  • 要使用颜色名称,请指定一个 CSS 颜色名称。有关 CSS 颜色名称的列表,请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords

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

示例: "blue"

示例: "#0000ff"

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

文本的字体大小,指定为字符向量或字符串标量,其中包含一个数值和一个单位。例如,"11pt" 指定 11 磅。有效的缩写是:

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

使用粗体显示文本的选项,指定为数值或逻辑值 1 (true) 或 0 (false)。要使文本变为粗体,请将此属性设置为 true1

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: logical

是否对文本使用斜体,指定为数值或逻辑值 1 (true) 或 0 (false)。如果 Italictrue1,则文本以斜体呈现。如果 Italicfalse0,文本将以直线形式显示。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: logical

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

  • "single" - 单条水平线

  • "none" -无删除线

  • "double" - 双水平线

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

是否以下标形式显示文本,下标形式可指定为数值或逻辑值 1 (true) 或 0 (false)。如果 Subscripttrue1,则文本呈现为下标。如果 Subscriptfalse0,则文本将呈现为常规文本。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: logical

是否以上标形式显示文本,上标形式可指定为数值或逻辑值 1 (true) 或 0 (false)。如果 Superscripttrue1,则文本呈现为上标。如果 Superscriptfalse0,则文本将呈现为常规文本。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: logical

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

描述
"single"单下划线
"double"双下划线
"heavy"粗下划线
"words"仅对单词加下划线(不包括空格)
"dotted"点状下划线
"dottedheavy"粗点状下划线
"dash"虚线下划线
"dashheavy"粗虚线下划线
"dashlong"长虚线下划线
"dashlongheavy"粗长虚线下划线
"dotdash"点划线下划线
"dotdashheavy"粗点划线下划线
"dotdotdash"双点划线下划线
"dotdotdashheavy"粗双点划线下划线
"wavy"波浪下划线
"wavyheavy"粗波浪下划线
"wavydouble"双波浪下划线
"none"无下划线

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

包含 CSS 颜色名称或十六进制 RGB 值的背景颜色,指定为字符向量或字符串标量。

  • 要使用颜色名称,请指定一个 CSS 颜色名称。要查看 CSS 颜色名称列表,请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords

  • 要指定十六进制 RGB 格式,请使用 # 作为第一个字符,并使用两位十六进制数作为红色、绿色和蓝色值。

注意

设置 BackgroundColor 属性会将 mlreportgen.ppt.BackgroundColor 格式的对象添加到 Style 属性。将 BackgroundColor 属性设置为空值将删除该对象。

示例: "blue"

示例: "#0000ff"

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

文本的垂直对齐方式,指定为以下值之一:

描述

"top"

垂直对齐至顶部

"bottom"

垂直对齐到表条目的底部

"middle"

垂直对齐到表条目的中间

"topCentered"

垂直对齐到表条目的顶部,水平对齐到表条目的中心

"bottomCentered"

垂直对齐到表条目的底部,水平对齐到表条目的中心

"middleCentered"

垂直对齐到中间,水平对齐到表条目的中心

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

左上角 x 坐标位置,指定为字符向量或字符串标量,其中包含一个数字,后跟一个测量单位的缩写。例如,"5in" 指定五英寸。有效的缩写是:

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

注意

当 PPT API 创建 mlreportgen.ppt.TextBoxPlaceholder 对象时,此属性值以英制公制单位 (EMU) 指定。如果设置此属性,则必须使用前面列表中的单位之一。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

左上角 y 坐标位置,指定为字符向量或字符串标量,其中包含一个数字,后跟一个测量单位的缩写。例如,"5in" 指定五英寸。有效的缩写是:

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

注意

当 PPT API 创建 mlreportgen.ppt.TextBoxPlaceholder 对象时,此属性值以英制公制单位 (EMU) 指定。如果设置此属性,则必须使用前面列表中的单位之一。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

占位符的宽度,指定为字符向量或字符串标量,其中包含一个数字,后跟一个测量单位的缩写。例如,"5in" 指定五英寸。有效的缩写是:

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

占位符的高度,指定为字符向量或字符串标量,其中包含一个数字,后跟一个测量单位的缩写。例如,"5in" 指定五英寸。有效的缩写是:

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

占位符格式,指定为由 PPT 格式对象组成的元胞数组。不适用于 TextBoxPlaceholder 对象的格式将被忽略。

通过将 Style 属性的现有值与包含要添加的格式对象元胞数组连接起来来添加格式对象。例如:

import mlreportgen.ppt.*
ppt = Presentation;

slide = add(ppt,"Title Slide");
content = find(slide,"Title");
placeholderObj = content(1);
placeholderObj.Style = [placeholderObj.Style {Bold(true),FontColor("red")}];

请参阅演示格式化方法

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

此对象的父级,指定为 PPT API 对象。一个 PPT API 对象只能有一个父对象。

属性:

GetAccess
public
SetAccess
private
NonCopyable
true

此对象的子元素,指定为由 PPT API 对象组成的元胞数组。

属性:

GetAccess
public
SetAccess
private
NonCopyable
true

数据类型: cell

标记,指定为字符向量或字符串标量。PPT API 在创建此对象的过程中生成一个会话唯一标记。生成的标记形式为 CLASS:ID,其中 CLASS 是对象类,ID 是对象的 Id 属性的值。使用此值来帮助确定在文档生成过程中出现的问题的位置。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

目标标识符,指定为字符向量或字符串标量。PPT API 在创建文档元素对象时会生成一个会话唯一标识符。您可以为 Id 指定自己的值。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

方法

全部展开

示例

全部折叠

向演示文稿添加标题幻灯片,然后用标题和副标题文本替换标题和副标题的幻灯片占位符。

导入 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.BodyPlaceholdermlreportgen.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 中推出