mlreportgen.ppt.AutoFit 类

命名空间: mlreportgen.ppt

缩放文本以适合占位符或文本框

自 R2020a 起

描述

使用 mlreportgen.ppt.AutoFit 格式对象缩放文本以适合 PPT API 幻灯片中的占位符或文本框。将 AutoFit 对象添加到 mlreportgen.ppt.ContentPlaceholder、mlreportgen.ppt.TextBoxPlaceholder 或 mlreportgen.ppt.TextBox 对象的 Style 属性。

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

创建对象

描述

autoFitObj = AutoFit 缩放内容占位符或文本框中的文本。通过设置 FontScale 属性来指定缩放百分比。

示例

如果 tf 为真，则 autoFitObj = AutoFit(tf) 缩放文本。通过设置 FontScale 属性来指定缩放百分比。

如果 tf 是 true，则 autoFitObj = AutoFit(tf,fontScale) 缩放文本。文本按 fontScale 指定的百分比缩放。请参阅 FontScale 属性。

属性

全部展开

`Value` — 是否缩放文本
`true` (默认) | `false`

是否缩放文本以适合占位符或文本框，指定为以下值之一：

true - 缩放文本（默认）
false - 不缩放文本

`FontScale` — 文本字体缩放值
`'92.5%'` (默认) | 字符向量 | 字符串标量

文本字体缩放值，指定为字符向量或字符串标量。此属性指定文本字体大小的缩放百分比。使用指定的百分比将文本缩放一次。如果文本仍然不适合占位符或文本框，请减少 FontScale 值直到文本适合。

`Id` — 此 PPT API 对象的 ID
字符向量 | 字符串标量

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

属性：

NonCopyable true

数据类型: char | string

`Tag` — 此 PPT API 对象的标签
字符向量 | 字符串标量

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

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

属性：

NonCopyable true

数据类型: char | string

示例

全部折叠

缩放文本以适合内容占位符

为了使文本适合内容占位符，请创建一个 mlreportgen.ppt.AutoFit 格式的对象，并将 Value 属性设置为 true，然后将该对象添加到 mlreportgen.ppt.ContentPlaceholder 对象的 Style 属性。此示例添加一张文本未缩放的幻灯片和一张文本已缩放的幻灯片。

创建演示文稿。

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

将第一张幻灯片添加到演示文稿中。此幻灯片中的内容占位符不会缩放文本以适应其大小。

slide1 = add(ppt,"Title and Content");
contentPlaceholder = find(slide1,"Content");
replace(contentPlaceholder,Paragraph(char(randi(25,1,1000)+97)));
contentPlaceholder.Style = [contentPlaceholder.Style {AutoFit(false)}];

将第二张幻灯片添加到演示文稿中。此幻灯片中的内容占位符会缩放文本以适合大小。

slide2 = add(ppt,"Title and Content");
contentPlaceholder = find(slide2,"Content");
replace(contentPlaceholder(1),Paragraph(char(randi(25,1,1000)+97)));
contentPlaceholder.Style = [contentPlaceholder.Style {AutoFit(true)}];

关闭并查看演示文稿。