Main Content

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

mlreportgen.ppt.Text 类

命名空间: mlreportgen.ppt

演示文稿中要包含的文本

全页展开

描述

使用 mlreportgen.ppt.Text 类的对象将文本包含在 PPT API 演示文稿中。

mlreportgen.ppt.Text 类是一个 handle 类。

类属性

HandleCompatible
true
ConstructOnLoad
true

有关类属性的信息，请参阅类属性。

创建对象

描述

textObj = mlreportgen.ppt.Text 创建一个空 mlreportgen.ppt.Text 对象。

textObj = mlreportgen.ppt.Text(content) 创建一个 mlreportgen.ppt.Text 对象，并将 Content 属性设置为 content。

示例

属性

全部展开

此文档元素包含的文本，指定为字符向量或字符串标量。

属性：

NonCopyable
true

数据类型: char | string

是否对文本使用粗体，指定为 true 或 false。指定 true 表示粗体文本。

数据类型: logical

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

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

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

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

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

文本的字体大小，指定为由数字和测量单位组成的字符向量或字符串标量。例如，'11pt' 指定 11 个点。有效的缩写是：

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

数据类型: char | string

是否对文本使用斜体，指定为 true 或 false。指定 true 表示斜体文本。

数据类型: logical

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

  • 'single' - 单条水平线

  • 'none' - 没有删除线

  • 'double' - 双水平线

是否将文本显示为下标，指定为 true 或 false。true 设置将文本呈现为下标。

数据类型: logical

是否将文本显示为上标，指定为 true 或 false。true 设置将文本呈现为上标。

数据类型: logical

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

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

文本格式，指定为 PPT 格式对象的元胞数组。

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

txt = mlreportgen.ppt.Text('my text');
txt.Style = [txt.Style {Bold(true),FontColor('red')}];

请参阅演示格式化方法。

不使用此属性。

该对象的父级，指定为 PPT 对象。

属性：

SetAccess
private
NonCopyable
true

此 PPT API 对象的标签，指定为字符向量或字符串标量。在创建此对象的过程中会生成一个会话唯一标签。生成的标签形式为 CLASS:ID，其中 CLASS 是对象类，ID 是对象的 Id 属性的值。

指定您自己的标签值可以帮助您识别演示文稿生成过程中出现问题的位置。

属性：

NonCopyable
true

数据类型: char | string

此 PPT API 对象的 ID，指定为字符向量或字符串标量。会话唯一 ID 是在对象创建过程中生成的。您可以指定一个 ID 来 替换生成的 ID。

属性：

NonCopyable
true

数据类型: char | string

方法

全部展开

示例

全部折叠

打开实时脚本

使用 mlreportgen.ppt.Text 对象向演示文稿添加文本。此示例使用 mlreportgen.ppt.Text 对象向一张幻灯片的标题和另一张幻灯片的内容添加文本。

创建演示文稿。

import mlreportgen.ppt.*
ppt = Presentation("myTextPresentation.pptx");
open(ppt);

在演示文稿中添加两张幻灯片。

slide1 = add(ppt,"Title Slide");
slide2 = add(ppt,"Title and Content");

创建一个 mlreportgen.ppt.Paragraph 对象作为演示文稿的标题。

p1 = Paragraph;

创建一个具有粗体和红色内容的 mlreportgen.ppt.Text 对象，并将其追加到段落。

titleText = Text("My Presentation Title");
titleText.Bold = true;
titleText.FontColor = "red";
append(p1,titleText);

用段落替换第一张幻灯片中的标题。

replace(slide1,"Title",p1);

为第二张幻灯片的内容创建一个段落。

 p2 = Paragraph("My content");
 append(p2,Text(" for the second slide"));

用该段落替换第二张幻灯片中的内容。

 replace(slide2,"Content",p2);

关闭并查看演示文稿。

close(ppt);
rptview(ppt);

以下是生成的演示文稿中的幻灯片：

版本历史记录

在 R2015b 中推出

另请参阅

| | |

主题