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

mlreportgen.ppt.AutoFit 类

命名空间: mlreportgen.ppt

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

全页展开

描述

使用 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 属性。

属性

全部展开

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

  • true - 缩放文本（默认）

  • false - 不缩放文本

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: logical

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

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

标记，指定为字符向量或字符串标量。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

示例

全部折叠

为了使文本适合内容占位符，请创建一个 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)}];

关闭并查看演示文稿。

close(ppt);
rptview(ppt);

版本历史记录

在 R2020a 中推出

另请参阅

| |

主题