Main Content

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

mlreportgen.ppt.Paragraph 类

命名空间: mlreportgen.ppt

格式化的文本模块(段落)

描述

使用 mlreportgen.ppt.Paragraph 类的对象将段落包含在 PPT API 演示文稿中。一个段落可以包含文本或 mlreportgen.ppt.Textmlreportgen.ppt.InternalLinkmlreportgen.ppt.ExternalLink 对象。

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

类属性

HandleCompatible
true
ConstructOnLoad
true

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

创建对象

描述

paragraphObj = mlreportgen.ppt.Paragraph 创建一个空的段落对象。

示例

paragraphObj = mlreportgen.ppt.Paragraph(text) 创建一个包含 mlreportgen.ppt.Text 对象的段落,该段落的文本由 text 指定。

paragraphObj = mlreportgen.ppt.Paragraph(pptElementObj) 创建一个包含 pptElementObj 指定的文本、内部链接或外部链接的段落。

输入参量

全部展开

段落文本,指定为字符向量或字符串标量。

要包含在段落中的演示元素,指定为 mlreportgen.ppt.Textmlreportgen.ppt.InternalLinkmlreportgen.ppt.ExternalLink 对象。

属性

全部展开

是否对此段落中的文本使用粗体,指定为 truefalsefalse 的设置使用常规粗细文本。true 设置将使文本以粗体呈现。

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

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

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

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

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

用于文档元素的字体大小,由数字和后跟计量单位缩写组成,指定为字符向量或字符串标量。例如,"12pt" 指定十二个点。有效的缩写是:

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

注意

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

示例: "12pt"

属性:

NonCopyable
true

数据类型: char | string

是否对本段落中的文本使用斜体,指定为 truefalsetrue 设置将使文本以斜体显示。

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

  • 'single' - 单条水平线

  • 'none' - 没有删除线

  • 'double' - 双水平线

是否将此段落中的文本显示为下标,指定为 truefalsetrue 设置将文本呈现为下标。

是否将此段落中的文本显示为上标,指定为 truefalsetrue 设置将文本呈现为上标。

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

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

本段落文本的水平对齐方式,指定为以下值之一:

  • 'center' - 居中

  • 'left' - 左对齐

  • 'right' - 右对齐

  • 'justified' - 左对齐和右对齐,单词间距均匀

  • 'distributed' - 左对齐和右对齐,字母间距均匀

  • 'thaiDistributed' - 左对齐和右对齐的泰语文本,字符间距均匀

  • 'justifiedLow' - 阿拉伯语文本的对齐

本段落的缩进级别,指定为 [1,9] 范围内的整数。值 1 表示没有缩进的顶层段落。

段落格式,指定为 PPT 格式对象的元胞数组。

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

para = mlreportgen.ppt.Paragraph('my paragraph');
para.Style = [para.Style {Bold(true),FontColor('red')}];

请参阅演示格式化方法

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

属性:

NonCopyable
true

该对象的父级,指定为 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

方法

全部展开

示例

全部折叠

创建一个包含两张幻灯片的演示文稿。

import mlreportgen.ppt.*;

ppt = Presentation('myParagraphPresentation.pptx');
open(ppt);

add(ppt,'Title Slide');
add(ppt,'Title and Content');

创建一个 mlreportgen.ppt.Paragraph 对象用于标题。使文本变为粗体和红色。

p = Paragraph('My Title');
p.Bold = true;
p.FontColor = 'red';

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

contents = find(ppt,'Title');
replace(contents(1),p);

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

p1 = Paragraph('My slide content');
append(p1,' for the second slide');

p1 段落替换内容。

replace(ppt,'Content',p1);

关闭并查看演示文稿。

close(ppt);
rptview(ppt);

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

Slide has a red and bold title. Slide has one bullet "My slide content for the second slide

版本历史记录

在 R2015b 中推出