Main Content

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

mlreportgen.dom.DOCXSection 类

命名空间: mlreportgen.dom
超类: mlreportgen.dom.DOCXPageLayout

（待删除）Microsoft Word 文档节中的页面格式和布局

全页展开

在以后的版本中将会删除 mlreportgen.dom.DOCXSection。请改用 mlreportgen.dom.DOCXPageLayout。

描述

使用 mlreportgen.dom.DOCXSection 对象定义 Word 文档节中的页面格式、页眉和页脚。

如果这是文档中的第一个 DOCXSection，那么它将控制从文档开头到这个 DOCXSection 的所有文档元素的页面布局。

如果这是文档中的第二个或后续的 DOCXSection，那么它将控制从前一个 DOCXSection 到其自身的所有文档元素的页面布局。

在设置 DOCXSection 对象的属性（例如边距宽度）之前，请打开包含 DOCXSection 对象的 Document 对象。

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

创建对象

描述

docxSectionObj = DOCXSection 创建一个空的文档节。

示例

属性

全部展开

您最多可以为一个布局定义三个页脚，分别用于：

  • 节的第一页

  • 偶数页

  • 奇数页

您最多可以为一个布局定义三个页眉，分别用于：

  • 节的第一页

  • 偶数页

  • 奇数页

此节中的边距大小和页面方向，指定为 mlreportgen.dom.DOCXPageMargins 对象。

此节中的页面大小，指定为 mlreportgen.dom.DOCXPageSize 对象。

此节中的页面边框，指定为 mlreportgen.dom.PageBorder 对象。

字符向量元胞数组，每个字符向量包含 Word 格式的 Word XML 标记。有关 Word 格式的 XML 标记的信息，请参阅 https://ecma-international.org/publications-and-standards/standards/ecma-376/。

此文档元素对象的格式规范，指定为格式对象数组。此属性指定的格式将覆盖此元素的 StyleName 属性指定的相应格式。不适用于此元素的格式将被忽略。

属性：

NonCopyable
true

数据类型: cell

mlreportgen.dom.DOCXSection 对象的父级，指定为文档元素对象。一个文档元素必须只有一个父元素。

属性：

SetAccess
private
NonCopyable
true

mlreportgen.dom.DOCXSection 对象的标签，指定为字符向量或字符串标量。DOM API 在创建此对象的过程中生成一个会话唯一标签。生成的标签形式为 CLASS:ID，其中 CLASS 是对象类，ID 是对象的 Id 属性的值。指定您自己的标签值，以帮助您确定在文档生成过程中出现问题时要查找的位置。

属性：

NonCopyable
true

数据类型: char | string

mlreportgen.dom.DOCXSection 对象的对象标识符，指定为字符向量或字符串标量。DOM API 在创建文档元素对象时会生成一个会话唯一标识符。您可以为 Id 指定自己的值。

属性：

NonCopyable
true

数据类型: char | string

示例

全部折叠

创建 Word 报 告。d.CurrentPageLayout 的值是 []。

import mlreportgen.dom.*;
d = Document("mydoc","docx");

打开文档，该文档从默认模板生成一个 DOCXSection 对象，并将该对象的句柄分配给 d.CurrentPageLayout。

open(d);

将文档 DOCXSection 对象的句柄分配给 DOCXSection 对象 s。

s = d.CurrentPageLayout;

更改 s 的左边距。

s.PageMargins.Left = "0.5in";

添加一些内容并显示报告。

p = Paragraph("Hello World");
append(d,p);

close(d);
rptview("mydoc.docx");

版本历史记录

在 R2014b 中推出

另请参阅

| | | | | | |

主题