mlreportgen.ppt.Paragraph 类
命名空间: mlreportgen.ppt
格式化的文本模块(段落)
描述
使用 mlreportgen.ppt.Paragraph
类的对象将段落包含在 PPT API 演示文稿中。一个段落可以包含文本或 mlreportgen.ppt.Text
、mlreportgen.ppt.InternalLink
或 mlreportgen.ppt.ExternalLink
对象。
mlreportgen.ppt.Paragraph
类是一个 handle
类。
创建对象
描述
创建一个空的段落对象。paragraphObj
= mlreportgen.ppt.Paragraph
创建一个包含 paragraphObj
= mlreportgen.ppt.Paragraph(pptElementObj
)pptElementObj
指定的文本、内部链接或外部链接的段落。
输入参量
text
— 段落文本
字符向量 | 字符串标量
段落文本,指定为字符向量或字符串标量。
pptElementObj
— 段落中要包含的演示元素
mlreportgen.ppt.Text
对象 | mlreportgen.ppt.InternalLink
| mlreportgen.ppt.ExternalLink
对象
要包含在段落中的演示元素,指定为 mlreportgen.ppt.Text
、mlreportgen.ppt.InternalLink
或 mlreportgen.ppt.ExternalLink
对象。
属性
Bold
— 是否对文本使用粗体
[]
(默认) | true
| false
是否对此段落中的文本使用粗体,指定为 true
或 false
。false
的设置使用常规粗细文本。true
设置将使文本以粗体呈现。
Font
— 文本的字体系列
[]
(默认) | 字符向量 | 字符串标量
本段落中文本的字体系列,指定为字符向量或字符串标量。指定 Microsoft® PowerPoint® 中的字体列表中出现的字体。要查看字体列表,请在 PowerPoint 的主页选项卡上的字体组中点击字体右侧的箭头。
ComplexScriptFont
— 复杂脚本的字体系列
[]
(默认) | 字符向量 | 字符串标量
复杂脚本的字体系列,指定为字符向量或字符串标量。指定在需要使用复杂脚本(如阿拉伯语或亚洲语)来呈现文本的区域设置中替换时要使用的字体系列。
FontColor
— 文本的字体颜色
[]
(默认) | 字符向量 | 字符串标量
本段落中文本的字体颜色,指定为由 CSS 颜色名称或十六进制 RGB 值组成的字符向量或字符串标量。
有关 CSS 颜色名称的列表,请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。
要指定十六进制 RGB 格式,请使用
#
作为第一个字符,并使用两位十六进制数作为红色、绿色和蓝色值。例如,'#0000ff'
指定蓝色。
FontSize
— 文档元素的字体大小
[]
(默认) | 字符向量 | 字符串标量
用于文档元素的字体大小,由数字和后跟计量单位缩写组成,指定为字符向量或字符串标量。例如,"12pt"
指定十二个点。有效的缩写是:
"px"
- 像素"cm"
- 厘米"in"
- 英寸"mm"
- 毫米"pc"
- 派卡"pt"
- 磅
注意
设置 FontSize
属性会将相应的 mlreportgen.dom.FontSize
格式对象添加到 Style
属性。将 FontSize
属性设置为空值将删除该对象。
示例: "12pt"
属性:
NonCopyable | true |
数据类型: char
| string
Italic
— 是否使用斜体文本
[]
(默认) | true
| false
是否对本段落中的文本使用斜体,指定为 true
或 false
。true
设置将使文本以斜体显示。
Strike
— 文本删除线样式
[]
(默认) | 'single'
| 'none'
| 'double'
本段落文本的删除线样式,指定为以下值之一:
'single'
- 单条水平线'none'
- 没有删除线'double'
- 双水平线
Subscript
— 是否将文本显示为下标
[]
(默认) | true
| false
是否将此段落中的文本显示为下标,指定为 true
或 false
。true
设置将文本呈现为下标。
Superscript
— 是否将文本显示为上标
[]
(默认) | true
| false
是否将此段落中的文本显示为上标,指定为 true
或 false
。true
设置将文本呈现为上标。
Underline
— 文本下划线样式
[]
(默认) | 'single'
| 'double'
| ...
本段落文本的下划线样式,指定为以下值之一:
值 | 描述 |
---|---|
"single" | 单下划线 |
"double" | 双下划线 |
"heavy" | 粗下划线 |
"words" | 仅对单词加下划线(不包括空格) |
"dotted" | 点线下划线 |
"dottedheavy" | 粗点线下划线 |
"dash" | 虚线下划线 |
"dashheavy" | 粗虚线下划线 |
"dashlong" | 长虚线下划线 |
"dashlongheavy" | 粗长虚线下划线 |
"dotdash" | 点划线下划线 |
"dotdashheavy" | 粗点划线下划线 |
"dotdotdash" | 双点划线下划线 |
"dotdotdashheavy" | 粗双点划线下划线 |
"wavy" | 波浪下划线 |
"wavyheavy" | 粗波浪下划线 |
"wavydouble" | 双波浪下划线 |
"none" | 无下划线 |
HAlign
— 文本的水平对齐方式
[]
(默认) | 字符向量 | 字符串标量
本段落文本的水平对齐方式,指定为以下值之一:
'center'
- 居中'left'
- 左对齐'right'
- 右对齐'justified'
- 左对齐和右对齐,单词间距均匀'distributed'
- 左对齐和右对齐,字母间距均匀'thaiDistributed'
- 左对齐和右对齐的泰语文本,字符间距均匀'justifiedLow'
- 阿拉伯语文本的对齐
Level
— 段落缩进级别
[]
(默认) | [1,9] 范围内的整数
本段落的缩进级别,指定为 [1,9] 范围内的整数。值 1
表示没有缩进的顶层段落。
Style
— 段落格式
PPT 格式对象的元胞数组
段落格式,指定为 PPT 格式对象的元胞数组。
通过将 Style
属性的现有值与包含要添加的格式对象的元胞数组连接起来来添加格式对象。例如:
para = mlreportgen.ppt.Paragraph('my paragraph'); para.Style = [para.Style {Bold(true),FontColor('red')}];
请参阅演示格式化方法。
Children
— 此 PPT API 对象的子项
PPT API 对象的元胞数组
此 PPT API 对象的子元素,指定为 PPT API 对象的元胞数组。
属性:
NonCopyable | true |
Parent
— 此 PPT API 对象的父级
PPT 对象
该对象的父级,指定为 PPT 对象。
属性:
SetAccess | private |
NonCopyable | true |
Tag
— 此 PPT API 对象的标签
字符向量 | 字符串标量
此 PPT API 对象的标签,指定为字符向量或字符串标量。在创建此对象的过程中会生成一个会话唯一标签。生成的标签形式为 CLASS:ID
,其中 CLASS
是对象类,ID
是对象的 Id
属性的值。
指定您自己的标签值可以帮助您识别演示文稿生成过程中出现问题的位置。
属性:
NonCopyable | true |
数据类型: char
| string
Id
— 此 PPT API 对象的 ID
字符向量 | 字符串标量
此 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);
以下是生成的演示文稿中的幻灯片:
版本历史记录
在 R2015b 中推出
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)