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

mlreportgen.dom.PageMargins 类

命名空间: mlreportgen.dom

Microsoft Word 和 PDF 页面布局的页边距

全页展开

描述

使用 mlreportgen.dom.PageMargins 类的对象来指定 Microsoft® Word 或 PDF 报告节的页边距大小。

Word 和 PDF 文档的页眉和页脚的创建有所不同。例如，PDF 页眉和页脚的大小是固定的。Word 的页眉和页脚会扩展以适合内容。因此，使用相同值的顶部和底部页边距的外观可能会根据输出类型而有所不同。

此外，对于不同的输出类型，顶部和底部边距的处理方式也不同。即使边距设置相同，这些差异也会导致不同的分页符。

  • 对于 PDF，上边距的总高度等于此对象的 Top 属性的值加上 Header 属性的高度。正文从标题下方开始。对于 Word 文档，顶部边距和页眉会扩展，以防止页眉和正文重叠。

  • 类似地，PDF 底部边距的总高度等于此对象的 Bottom 属性的值加上 Footer 属性的高度。正文结束于页脚上方。对于 Word 文档，页脚会扩展以防止正文重叠。

mlreportgen.dom.PageMargins 类是一个 handle 类。

类属性

HandleCompatible
true
ConstructOnLoad
true

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

创建对象

描述

pageMarginsObj = mlreportgen.dom.PageMargins 创建一个 PageMargins 对象，该对象具有属性，这些属性指定 1 英寸的顶部、底部、左侧和右侧边距、0.5 英寸的页眉和页脚以及 0 像素的装订线。

示例

属性

全部展开

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

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

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

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

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

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

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

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

标题大小，指定为字符向量或字符串标量，包含一个数字，后跟一个测量单位的缩写。例如，"0.5in" 指定 0.5 英寸。有效的缩写是：

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

装订线尺寸，指定为字符向量或字符串标量，其中包含一个数字和一个单位缩写。例如，"0px" 指定 0 像素。有效的缩写是：

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

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

示例

全部折叠

打开实时脚本

在与文档布局对象关联的 PageMargins 对象中，指定 0.5 英寸的边距。

import mlreportgen.dom.*;
d = Document('myreport','docx');
open(d);
 
pageLayoutObj = d.CurrentPageLayout;
pageLayoutObj.PageMargins.Left  = '0.5in';
pageLayoutObj.PageMargins.Right = '0.5in';
append(d,'Left and right margins are 0.5 inches.');

close(d);
rptview(d);
打开实时脚本

使用 mlreportgen.dom.PageMargins 对象指定 0.5 英寸的边距。将该对象分配给报告布局对象的 PageMargins 属性。

import mlreportgen.report.*;
import mlreportgen.dom.*;

rpt = Report('myreport','docx');
open(rpt);
 
pageMarginsObj = PageMargins();
pageMarginsObj.Left = '0.5in';
pageMarginsObj.Right = '0.5in';
rpt.Layout.PageMargins = pageMarginsObj;

append(rpt,'Left and right margins are 0.5 inches.');
close(rpt);
rptview(rpt);

版本历史记录

在 R2016a 中推出

另请参阅

| | | | | | |

主题