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

mlreportgen.ppt.InnerMargin 类

命名空间: mlreportgen.ppt

内容和边界框之间的边距

自 R2026a 起

全页展开

描述

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

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

类属性

HandleCompatible
true
ConstructOnLoad
true

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

创建对象

描述

marginObj = mlreportgen.ppt.InnerMargin 创建了一个 InnerMargin 对象，其边距值设置为 []。

marginObj = mlreportgen.ppt.InnerMargin(all) 会在对象与其边界框之间的所有边上创建一个指定大小的内边距。

示例

marginObj = mlreportgen.ppt.InnerMargin(left,right) 会在对象及其边界框的左右两侧之间创建一个具有指定大小的内边距。

marginObj = mlreportgen.ppt.InnerMargin(left,right,top,bottom) 会在对象的各边与其边界框之间创建一个具有指定尺寸的内边距。

输入参量

全部展开

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

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

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

对象与其边界框之间的左边距大小。有关有效值的列表，请参阅 all 参量。

对象与其边界框之间的右侧边距大小。有关有效值的列表，请参阅 all 参量。

对象与其边界框之间的顶部间距大小。有关有效值的列表，请参阅 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

顶部边距的大小，指定为字符向量或字符串标量，其中包含一个数字，后跟一个计量单位的缩写。例如，"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

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

示例

全部折叠

打开实时脚本

本示例演示了如何为表条目设置内边距。您可以为整个表、指定的表行或指定的表条目设置内边距。

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

import mlreportgen.ppt.*

创建演示文稿。

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

向演示文稿中添加幻灯片。

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

创建一个表，并为表中的所有表条目指定内边距。

t = Table(magic(3));
t.TableEntriesInnerMargin = "0.1in";

请指定第一行条目的内边距。此设置将覆盖 Table 对象中指定的内边距。

row = t.row(1);
row.Style = [row.Style {InnerMargin("0.3in")}];

请指定第一行表中各条目的内边距。这些设置将覆盖 TableRow 对象和 Table 对象中指定的内边距。

te = t.entry(1,1);
te.InnerMargin = "0in";

在幻灯片中添加标题和表。

replace(slide,"Title","Table entries with custom inner margins");
replace(slide,"Table",t);

关闭并查看演示文稿。

close(ppt);
rptview(ppt);

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

Slide with the title "Table entries with custom inner margins" and a three by three table below it. The upper left entry has an inner margin or 0". The remainder of the first row has inner margins of 0.3". The second and third rows have inner margins of 0.1".

版本历史记录

在 R2026a 中推出

另请参阅

| | |