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

mlreportgen.ppt.OuterMargin 类

命名空间: mlreportgen.ppt

边界框与相邻演示文稿对象之间的外边距

自 R2026a 起

全页展开

描述

使用 mlreportgen.ppt.OuterMargin 类的对象来指定对象的边界框与相邻演示文稿对象之间的外边距。对象的边界框包含内边距和对象内容。如果对象有边框，则该框也包含该边框。

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

类属性

HandleCompatible
true
ConstructOnLoad
true

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

创建对象

描述

marginObj = mlreportgen.ppt.OuterMargin 会生成一个 OuterMargin，其边距值设置为 []。

marginObj = mlreportgen.ppt.OuterMargin(all) 会创建一个具有指定大小的外边距。

示例

marginObj = mlreportgen.ppt.OuterMargin(top,bottom) 会在对象的顶部和底部边缘与其边界框以及相邻的演示文稿对象之间创建一个具有指定大小的外边距。

输入参量

全部展开

对象边界框与相邻呈现对象之间各边的外边距，指定为字符向量或字符串标量，其中包含一个数字，后跟一个计量单位的缩写。例如，"10px" 指定 10 像素。有效的缩写是：

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

您也可以通过省略单位来指定像素值。例如，"5" 指定 5 像素。

对象边界框与相邻呈现元素对象之间的顶部边距大小，指定为字符向量或字符串标量，其中包含一个数字，后跟一个计量单位的缩写。有关有效值的列表，请参阅 all 参量。

对象边界框与相邻呈现元素对象之间的底部边距大小，指定为字符向量或字符串标量，其中包含一个数字，后跟一个计量单位的缩写。有关有效值的列表，请参阅 all 参量。

属性

全部展开

顶部边距的大小，指定为字符向量或字符串标量，其中包含一个数字，后跟一个计量单位的缩写。例如，"1in" 指定 1 英寸。有效的缩写是：

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

您也可以通过省略单位来指定像素值。例如，"5" 指定 5 像素。

示例: "0.5in"

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

底部边距的大小，指定为字符向量或字符串标量，其中包含一个数字，后跟一个计量单位的缩写。例如，"1in" 指定 1 英寸。有效的缩写是：

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

您也可以通过省略单位来指定像素值。例如，"5" 指定 5 像素。

示例: "0.5in"

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

标记，指定为字符向量或字符串标量。DOM API 在创建此对象的过程中生成一个会话唯一标记。生成的标记形式为 CLASS:ID，其中 CLASS 是对象类，ID 是对象的 Id 属性的值。使用此值来帮助确定在文档生成过程中出现的问题的位置。

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

目标标识符，指定为字符向量或字符串标量。DOM API 在创建文档元素对象时会生成一个会话唯一标识符。

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

示例

全部折叠

打开实时脚本

本示例演示了如何在演示文稿中为段落添加外边距。

导入 PPT API 命名空间，这样就无需使用冗长的完全限定名称了。

import mlreportgen.ppt.*

创建演示文稿。

ppt = Presentation("myOuterMargins.pptx");
open(ppt);

在演示文稿中添加一个 "Title and Content" 类型的幻灯片。

slide = add(ppt,"Title and Content");

创建多个段落，并将第二个段落的外边距设置为 "0.5in"。

p1 = Paragraph("First Line - default outer margin");
p2 = Paragraph("Second Line - 0.5 in outer margin");
p3 = Paragraph("Third Line - default outer margin");
p4 = Paragraph("Fourth Line - default outer margin");
p2.Style = {OuterMargin("0.5in")};

在幻灯片中添加标题和正文段落。

replace(slide,"Title","Outer Margin Example");
replace(slide,"Content",{p1 p2 p3 p4});

关闭并查看演示文稿。

close(ppt);
rptview(ppt);

这张图片展示了生成的 PPT。

Slide with the title "Outer Margin Example" and 4 bullet points. The second bullet has an 0.5 in margin above and below it.

版本历史记录

在 R2026a 中推出

另请参阅